Wij contacteren u om hieromtrent de onderstaande informatie met u te delen en raden u aan deze informatie te delen met uw technische integrator, ontwikkelaar of webmaster.

Gelieve kennis te nemen van een aankomende wijziging in het formaat van de Betaal ID (PAYID). Deze wijziging is noodzakelijk aangezien we de kaap van tien miljard betalingen in de productieomgeving naderen.

In principe zou deze wijziging transparant moeten verlopen, aangezien PAYID niet bedoeld is als veld met vaste lengte. Bepaalde integraties kunnen echter uitgaan van een bepaald PAYID-formaat (bijvoorbeeld hardcoded logica die exact tien cijfers verwacht of enkel de eerste tien cijfers leest). Dit kan een invloed hebben op de weergave van PAYID’s in API-responses en op uw reconciliatie van betalingen.

Wat houdt deze wijziging in?

• Worldline Legacy: de PAYID wordt uitgebreid van tien naar elf cijfers.
• Worldline Direct: het PAYID-formaat 9999999999_0 wordt 99999999999_0.
• Worldline Direct: het PAYID-formaat 9000009999999999000 wordt 9000099999999999000.

Opmerking voor gebruikers van PAYID19
Het formaat met negentien cijfers blijft ongewijzigd. De enige uitzondering betreft handelaars die PAYID19 omzetten naar PAYIDLegacy – de checksum-berekeningen moeten worden bijgewerkt voor de nieuwe lengte van elf cijfers.

Impact op gestructureerde mededeling (reconciliatie)
Op dit moment wordt de gestructureerde mededeling opgebouwd door de eerste tien cijfers van de PAYID te nemen en daarop een modulo 97-checksum toe te passen. Deze checksum wordt vervolgens toegevoegd aan de PAYID binnen een structuur van twaalf tekens. Een PAYID van tien cijfers, zoals 9999999999, resulteert bijvoorbeeld in de gestructureerde mededeling +++99999/9999/948+++.

Omdat de PAYID elf cijfers zal bevatten, volstaat de bestaande structuur van twaalf tekens niet langer. Om dit op te vangen, passen we de generatieregel aan. We gebruiken de tien meest rechtse cijfers van de PAYID van elf cijfers en passen daarop dezelfde modulo 97-checksum toe. Concreet: als de PAYID 10000000123 is, gebruiken we de tien meest rechtse cijfers 0000000123 en berekenen we de checksum (123 mod 97) om een nieuwe gestructureerde mededeling te vormen, namelijk +++00000/0012/326+++.

Om de oorspronkelijke PAYID te reconstrueren op basis van de gestructureerde mededeling, dient u 10000000000 toe te voegen aan de eerste tien cijfers.

Wanneer komt deze wijziging er?
We passen de Betaal ID’s aan naar 10000000000 in de PREPRODUCTIE (TEST)-omgeving op dinsdag 05/05/2026.

Moet ik zelf iets ondernemen?
We vragen u vriendelijk om uw reconciliatie en integraties te evalueren en te testen in de Preproductie (TEST)-omgeving. Dit laat u toe om eventuele gevolgen voor uw activiteiten tijdig te detecteren. We adviseren om vanaf woensdag 06/05/2026 de volgende stappen te ondernemen.

• Identificeer plaatsen waar PAYID als een tekenreeks van cijfers wordt behandeld.
• Controleer aannames over een vaste PAYID-lengte om fouten in validatielogica te detecteren.
• Controleer of het gebruik van PAYID als tekenreeks fouten veroorzaakt bij het invoegen in de database.

Wat met de PRODUCTIE-omgeving?
Er is op dit moment geen impact of update gepland in de PRODUCTIE-omgeving. Deze aanpassing zal naar verwachting in de tweede helft van 2026 worden uitgevoerd. U wordt ruim vooraf geïnformeerd over de exacte datum.

We brengen u nu al op de hoogte en passen de wijziging reeds toe in de Preproductie (TEST)-omgeving. Dit geeft u de nodige tijd om uw integraties te evalueren en te testen vóór de implementatie in de Productie-omgeving in de tweede helft van 2026.

Vragen?
Onze teams staan voor u klaar om u te ondersteunen bij eventuele vragen. Voor ondersteuning kunt u contact opnemen via uw gebruikelijke kanalen en “11-digit PAYID” vermelden in het onderwerp. Zo kunnen we uw vraag aan het juiste team bezorgen voor een vlotte afhandeling.

Bedankt voor uw begrip en medewerking.