Ca parte a eforturilor Mollie de a îmbunătăți fiabilitatea și securitatea sistemelor noastre, lucrăm la unificarea identificatorilor resurselor API sub un nou standard - identificatorii de plată și de comandă sunt următorii pe listă.
Ce se dezvoltă?
Istoric, identificatorii noștri API au constat în 10 caractere sau mai puțin (excluzând prefixul, exemplu: tr_XYZXYZXYZX). De la începutul anului, am fost în proces de actualizare a acestor identificatori vechi la un format mai lung, adăugând un supliment de 4 până la 12 caractere.
Resursele mai recente - precum Capturi și Linkuri de Platã - au fost introduse folosind acest format extins de la început. Rambursările, o resursă mai veche, au fost recent actualizate pentru a adopta noul format.
În continuare, această modificare se va aplica celor mai critice resurse ale noastre: Plăți (Plată nouă -> Răspuns -> ID) și Comenzi (Creare comandă -> Răspuns -> ID).
Ce înseamnă asta pentru tine?
Dacă utilizați una dintre integrările predefinite, precum WooCommerce, Shopify sau Magento 2, nu ar trebui să existe niciun impact din cauza acestei modificări. Am revizuit aceste integrări și nu am identificat probleme de compatibilitate.
Cu toate acestea, dacă ai o integrară personalizată cu Mollie și/sau integrări suplimentare downstream care gestionează aceste referințe la plată (de exemplu, ERP, managementul comenzilor sau sisteme de contabilitate), te rugăm să îți aloci un moment pentru a revizui următoarele:
- Stocarea în baza de date: Dacă stochezi acești identificatori, asigură-te că lungimea câmpului nu este limitată la doar 10 caractere. Recomandăm o lungime a câmpului de cel puțin 40 de caractere sau mai mult pentru a fi pregătit pentru viitor.
- Validare personalizată: Asigură-te că orice validare personalizată a identificatorului pe care o ai poate să acomodeze formatul mai lung. Recomandăm ca, dacă decizi să validezi formatul tokenului, să verifici doar că prefixul se potrivește așteptărilor tale și să eviți validarea restului tokenului.
Această actualizare nu ar trebui să perturbe procesarea plăților, dar gestionarea incorectă a noilor identificatori ar putea duce la nepotriviri. Puteți găsi informații suplimentare despre noul standard aici.
Pregătește-te pentru o tranzacție de test:
Vom efectua o singură tranzacție de test pentru fiecare combinație unică de profil/user_agent/client_id utilizând noii identificatori API pe 5 Iunie, începând de la ora 2 am CET. Prin urmare, dirijăm prima tranzacție care va fi efectuată să folosească noul format de token. Toate tranzacțiile ulterioare vor folosi din nou standardul vechi, până vom începe desfășurarea pe 12 Iunie.
Dacă apar probleme după acest test, îți vom oferi opțiunea de a te retrage temporar din schimbare. Îți vom trimite un email cu un formular referitor la retragere pe 6 Iunie.
Rezolvarea problemelor
Dacă sistemele tale au probleme neașteptate în a gestiona noul format de token, poți gestiona tranzacția (ex. anulare/rambursare/captură) manual în Mollie Dashboard navigând la Comenzi/Plăți, selectând tranzacția relevantă și efectuând acțiunea dorită acolo.
Notă: Organizăm o ședință Q&A pe 2 iunie pe Discord. De asemenea, puteți adresa orice întrebări în acest canal Discord.
Termene:
- 2 iunie: Sesiune Q&A - Alăturați-vă pe Discord
- 5 Iunie: Tranzacție de test unică per combinație unică de profil/user-agent/client_id
- 6 Iunie: Email de follow-up, cu opțiunea de a te retrage temporar din schimbarea tokenului nou
- 12 Iunie: Începutul desfășurării treptate a noului format de token (excl. retrageri)
- 8 Iulie: desfășurarea 100% a noului format de token (excl. retrageri)
-
31 decembrie: Sfârșitul perioadei de renunțare, migrarea tuturor profilelor rămase.