Kot del prizadevanj podjetja Mollie za izboljšanje zanesljivosti in varnosti naših sistemov, delamo na poenotenju naših identifikatorjev API virov pod novim standardom - identifikatorji plačil in naročil so naslednji na vrsti.
Kaj se spreminja?
Historically, our API identifiers consisted of 10 characters or less (excluding the prefix, example: tr_XYZXYZXYZX). Od začetka leta nadgrajujemo te stare identifikatorje na daljši format, pri čemer dodajamo dodatne 4 do 12 znakov.
Noviji viri - kot so zajemi in plačilne povezave - so bili predstavljeni s tem razširjenim formatom že od začetka. Vračila, starejši vir, so bila pred kratkim posodobljena, da sprejmejo nov format.
Nato se bo ta sprememba uporabljala za naše najbolj ključne vire: Plačila (Ustvari plačilo -> Odziv -> ID) in Naročila (Ustvari naročilo -> Odziv -> ID).
Kaj to pomeni za vas?
Če uporabljate eno od naših vnaprej pripravljenih integracij, kot so WooCommerce, Shopify ali Magento 2, te spremembe ne bi smele vplivati na vas. Preučili smo te integracije in nismo identificirali nobenih težav s združljivostjo.
Vendar, če imate po meri izdelano integracijo s podjetjem Mollie in/ali dodatne downstream integracije, ki obravnavajo te referenčne številke plačil (na primer, ERP, sistem za upravljanje naročil ali računovodski sistemi), si vzemite trenutek, da pregledate naslednje:
- Shranjevanje podatkov: Če shranjujete te identifikatorje, poskrbite, da dolžina polja ne bo omejena na le 10 znakov. Priporočamo dolžino polja najmanj 40 znakov ali več za zaščito pred prihodnjimi težavami.
- Prilagojena validacija: Prepričajte se, da lahko kakršna koli prilagojena validacija identifikatorjev, ki jo imate, obravnava daljši format. Priporočamo, da če se odločite za validacijo formata tokena, preverite le, da se predpona ujema z vašimi pričakovanji in se izogibate preverjanju preostalega dela tokena.
Ta posodobitev ne sme motiti obdelave plačil, vendar lahko nepravilno ravnanje z novimi identifikatorji povzroči neskladja. Dodatne informacije o novem standardu lahko najdete tukaj.
Pripravite se na testno transakcijo:
Izvedli bomo eno testno transakcijo na vsakem edinstvenem profilu/kombinaciji uporabniškega agenta/ID stranke z uporabo novih identifikatorjev API 5. junija, začenši ob 2. uri CET. Zato bomo preusmerili prvo transakcijo, ki se bo izvedla z novim formatom tokena. Vse naslednje transakcije bodo ponovno uporabljale star standard, dokler ne začnemo uvajanja 12. junija.
Če se po tej testni transakciji pojavijo kakršne koli težave, vam bomo ponudili možnost, da se začasno izključite iz spremembe. Pošljemo vam bomo e-pošto s obrazcem za izključitev 6. junija.
Odpravljanje težav
V primeru, da imajo vaši sistemi nenadoma težave z obvladovanjem novega formata tokena, lahko ročno upravljate transakcijo (npr. prekličite/vračilo/zajem) v svojem Mollie Dashboard tako, da se pomaknete do Naročil/Plačil, izberete ustrezno transakcijo in tam izvedete želeno dejanje.
Opomba: Pripravljamo Q&A sejo 2. junija na Discordu. Poleg tega lahko zastavite vsa vprašanja v tem Discord kanalu.
Časovnice:
- 2. junij: Q&A seja - Pridružite se nam na Discordu
- 5. junij: Enotna testna transakcija na edinstveno kombinacijo profila/uporabniškega agenta/ID-ja stranke
- 6. junij: E-pošta v zvezi z možnostjo začasnega izklopa iz spremembe formata tokena
- 12. junij: Začetek postopne uvedbe novega formata tokena (izklopite)
- 8. julij: 100 % uvajanja novega formata tokena (izklopite)
-
31. december: Konec obdobja za odjavo, migracija vseh preostalih profilov.