Wanneer een Wero betaling niet succesvol kan worden verwerkt, kan een ISO 20022 redencode worden teruggegeven. Deze code geeft aan waarom een betaling is afgewezen, niet kon worden verwerkt of niet kon worden afgerond.
Goed om te weten: een ISO 20022-redencode betekent niet automatisch dat er een probleem is met jouw integratie of betaalomgeving. De oorzaak kan ook bij de bank van de klant, de bank van de begunstigde of de betaalinfrastructuur liggen.
Wil je weten wat je kunt doen? Gebruik dan de onderstaande overzichten.
Waar vind ik deze redencodes?
Wanneer je een transactie opent in My.pay, zie je de Latest processing action.
Deze bestaat uit de volgende onderdelen:
- Laatste processing action: in het onderstaande voorbeeld is dit AuthorisationRejected.
- Reden code: in het onderstaande voorbeeld is dit FR01.
- Reden: in het onderstaande voorbeeld is dit Fraud suspected.
Betaling afgewezen tijdens autorisatie
Deze foutcodes worden teruggegeven wanneer een betaling niet kan worden geautoriseerd, bijvoorbeeld omdat de klant onvoldoende saldo heeft of een betalingslimiet is overschreden.
| Code | Betekenis | Aanbevolen actie voor de merchant |
|---|---|---|
| AB11 | Time-out bij de bank van de klant | Laat de klant de betaling opnieuw proberen. |
| AC03 | Ongeldig rekeningnummer van de begunstigde | Controleer de betaal- en begunstigdegegevens. |
| AC05 | Betaalrekening van de klant is gesloten | Laat de klant een andere betaalrekening of betaalmethode gebruiken. |
| AC06 | Rekening van de klant is geblokkeerd | Laat de klant contact opnemen met de bank of een andere betaalmethode gebruiken. |
| AG01 | Transactie is niet toegestaan | Laat de klant een andere betaalmethode gebruiken of contact opnemen met de bank. |
| AM02 | Bedrag is niet toegestaan | Controleer het bedrag. Laat de klant indien nodig een andere betaalmethode gebruiken. |
| AM04 | Onvoldoende saldo | Laat de klant controleren of er voldoende saldo beschikbaar is en opnieuw proberen. |
| AM21 | Betalingslimiet overschreden | Laat de klant de betalingslimiet bij de bank controleren of een andere betaalmethode gebruiken. |
| BE17 | Identificatie van de begunstigde ontbreekt of is ongeldig | Controleer de gegevens. |
| CURR | Ongeldige valuta | Controleer of de gebruikte valuta wordt ondersteund. |
| DS09 | Verzoek kon niet worden ontsleuteld | Technische fout. Probeer opnieuw. |
| DT01 | Ongeldige of ontbrekende datum | Controleer de configuratie en/of het verzoek. |
| DUPL | Dubbele betalingsautorisatie | Dien de betaling niet opnieuw in voordat de status van de oorspronkelijke betaling is gecontroleerd. |
| FF01 | Ongeldig verzoekformaat | Controleer de API-request en payload. |
| FR01 | Betaling geweigerd vanwege fraude- of veiligheidscontroles | Laat de klant een andere betaalmethode gebruiken of contact opnemen met de bank. |
| MS03 | Meerdere captures niet toegestaan | Controleer de capture-logica van de integratie. |
| NARR | Geen specifieke reden opgegeven | Laat de klant opnieuw proberen of een andere betaalmethode gebruiken. |
| RR04 | Betaling geweigerd vanwege regelgeving | Laat de klant een andere betaalmethode gebruiken of contact opnemen met de bank. |
| SL11 | Merchant staat niet op de whitelist van de klant | Laat de klant de merchant indien nodig toestaan via de bankomgeving. |
| SL12 | Merchant staat op de blacklist van de klant | Laat de klant contact opnemen met de bank of een andere betaalmethode gebruiken. |
| TK01 | Ongeldig of ingetrokken betalingstoken | Start een nieuwe betaalsessie. |
| TKSG | Eenmalig token is al gebruikt | Gebruik het token niet opnieuw. Start een nieuwe betaalsessie. |
| TKVE | Limiet van het betalingstoken overschreden | Controleer het bedrag en start indien nodig een nieuwe betaalsessie. |
| TKXP | Betalingstoken is verlopen | Start een nieuwe betaalsessie en laat de klant opnieuw proberen. |
Betaling mislukt tijdens verwerking of settlement
Deze foutcodes ontstaan nadat een betaling is geautoriseerd, maar tijdens de verdere verwerking via de SEPA instant betaalinfrastructuur niet kunnen worden voltooid. Deze fouten kunnen meestal niet door jou als merchant zelf worden opgelost.
| Code | Betekenis | Aanbevolen actie voor de merchant |
|---|---|---|
| AB05 | Time-out bij de bank van de begunstigde | Controleer de betaalstatus. Als de betaling niet is voltooid, kan opnieuw worden geprobeerd. |
| AB06 | Time-out binnen het clearing- en settlementproces | Controleer de betaalstatus en probeer opnieuw als de oorspronkelijke betaling niet is voltooid. |
| AB07 / AB08 | Bank of betaalinstantie van de begunstigde is offline | Laat de klant het later opnieuw proberen of een andere betaalmethode gebruiken. |
| AB09 | Verwerkingsfout bij de bank van de begunstigde | Laat de klant opnieuw proberen. |
| AB10 | Tijdelijk netwerk- of routeringsprobleem | Probeer de betaling later opnieuw. |
| AC01 / AC04 | Rekening van de begunstigde is onjuist of gesloten | Controleer de betaal- en begunstigdegegevens. |
| AG02 | Ongeldige betalingsroutering | Technische fout. |
| AG10 / AG11 | Betrokken betaalinstantie is geschorst | De betaling kan momenteel niet worden verwerkt. |
| AM05 | Dubbele betaling gedetecteerd | Dien de betaling niet opnieuw in voordat de oorspronkelijke betaalstatus is gecontroleerd. |
| AM23 | Bedrag overschrijdt de SEPA-schem limiet | Verlaag het bedrag of gebruik een andere betaalmethode. |
| BE04 | Bank van de begunstigde neemt niet deel aan het betreffende schema | Gebruik een andere betaalmethode. |
| CNOR / DNOR | Bank van de begunstigde of klant is offline | Laat de klant het later opnieuw proberen of een andere betaalmethode gebruiken. |
| MS02 | Geen specifieke reden opgegeven | Laat de klant opnieuw proberen of een andere betaalmethode gebruiken. |
| RC01 | Probleem met schema of betalingsroutering | Probeer opnieuw. |
| RR01 / RR02 / RR03 | Vereiste klantgegevens ontbreken | Controleer de beschikbare betaal- en klantgegevens. |
Wat moet ik doen bij een Wero foutmelding?
Gebruik onderstaande stappen als algemene richtlijn.
1. Controleer de betaalstatus
Controleer altijd eerst of de betaling daadwerkelijk is mislukt. Dien een betaling niet opnieuw in als de status onbekend is. De oorspronkelijke betaling kan nog worden verwerkt. Hiermee voorkom je dubbele betalingen.
2. Controleer of de fout door de klant kan worden opgelost
Bijvoorbeeld bij:
- onvoldoende saldo;
- een overschreden betalingslimiet;
- een geblokkeerde rekening;
- een probleem met de bank van de klant.
Laat de klant in deze gevallen de betaling opnieuw proberen, contact opnemen met de bank of een andere betaalmethode gebruiken.
3. Controleer je betaalgegevens en integratie
Bij fouten zoals een ongeldig rekeningnummer, ongeldig verzoekformaat of een probleem met een betalingstoken controleer je de betaalgegevens en je integratie.
4. Probeer opnieuw bij een tijdelijke fout
Bij een time-out, tijdelijke netwerkfout of tijdelijke serverfout kan de betaling opnieuw worden geprobeerd.
Let op: voorkom dat dezelfde betaling meerdere keren wordt ingediend.
5. Neem contact op met Pay.
Neem contact op met Pay. wanneer:
- de fout blijft terugkomen;
- de oorzaak niet duidelijk is;
- je vermoedt dat er een technisch probleem is;
- de betaalstatus niet kan worden vastgesteld.
Vermeld bij je melding altijd het Order ID, de eventuele ISO 20022 redencode, betaalreferentie en relevante request- of transactiedetails. Dit helpt om het probleem sneller te onderzoeken.
Samenvatting| Situatie | Actie |
|---|---|
| Probleem bij klant of bank van klant | Laat de klant opnieuw proberen, contact opnemen met de bank of een andere betaalmethode gebruiken. |
| Ongeldige betaalgegevens | Controleer en corrigeer de gegevens. |
| Tijdelijke technische fout | Probeer opnieuw volgens de retry-strategie. |
| Dubbele betaling of onduidelijke status | Niet opnieuw indienen. Eerst de betaalstatus controleren. |
| Integratie- of configuratieprobleem | Controleer de integratie en neem indien nodig contact met ons op. |
| Onbekende of terugkerende fout | Neem contact op met ons en vermeld minimaal de reden code en het order ID. |