Inleiding
De dubbelcheck in Axepta BNP Paribas Online is ontworpen om dubbele betaalpogingen te detecteren en te beheren over meerdere kanalen (API, HPP, etc.).
Het zorgt ervoor dat eindklanten en handelaars geen meerdere betalingen met identieke parameters per ongeluk triggeren, inclusief gevallen waarbij een betaling al in behandeling is.
Doelstellingen van de dubbelcheck Dubbele transacties kunnen verschillende oorzaken hebben:
- Gebruikersfouten (bv. pagina vernieuwen, dubbelklikken, tabblad sluiten)
- Problemen in de logica aan handelaarszijde (bv. herhaalpogingen in lussen)
- Netwerklatentie of wachttijden die onzekerheid veroorzaken over de betaalstatus
- Betaalpogingen die nog in behandeling zijn wanneer een nieuwe aanvraag wordt ingediend
Configuratie: De handelaar moet de volgende elementen kiezen, die aan de zijde van Axepta BNP Paribas Online worden geconfigureerd:
| Parameter | Beschrijving |
|---|---|
| Historische diepte | 1 uur tot 4 dagen (in uren) |
| Historische diepte verwijst naar de periode waarin het systeem eerdere transactiegegevens behoudt en analyseert om dubbele betaalpogingen te detecteren. Deze diepte is configureerbaar (1 uur tot 4 dagen) en hangt af van de behoeften van de handelaar. Het stelt nieuwe transacties in staat om vergeleken te worden met die binnen dit tijdsbestek, om dubbele betalingen te voorkomen. | |
| Bereik | 1 of meerdere MID (Merchant ID) |
| Reeds lopende betalingen meenemen | Ja/Nee |
Werking
1. Verificatie
Dubbelchecks worden geactiveerd voor het weergeven van de betaalpagina en tussen betaalpagina’s:
- Als een dubbel wordt gedetecteerd, wordt de gebruiker doorgestuurd naar de Failure URL.
- Er wordt geen betaling ingediend als de aanvraag overeenkomt met een bestaande of lopende transactie.
- Een mislukte transactie activeert geen dubbeldetectie.
2. Implementatie
Optie 1: Betaling via de Betaalmethode-selectiepagina (Hosted Payment Pae) of Kaartbetaalformulier (payssl).
Voeg minstens één van de volgende parameters toe aan API-oproepen naar /payments/sessions en /payments:
order.merchantReferenceorder.invoiceIdAmount(Bedrag)
Optie 2: Dubbelcheck via API – Binnenkort beschikbaar
De Axepta BNP Paribas Online API biedt een endpoint waarmee handelaren kunnen controleren of een transactie een dubbel is voordat deze wordt ingediend:
- Endpoint: binnenkort beschikbaar
- Parameters:
merchantReferenceofinvoiceId(verplicht),Amount,Currency.
3. Responsformaat
De API retourneert een status die aangeeft of een transactie een dubbel is:
| Status | Code | Beschrijving |
|---|---|---|
| OK | 00000000 | Geen dubbels gedetecteerd |
| FAILED | 2XXX1550 | Betaling reeds uitgevoerd |
| FAILED | 2XXX1551 | Betaling in behandeling |
| FAILED | 2XXX1552 | Meerdere dubbels gedetecteerd, extra criteria nodig |
Als een dubbel wordt gedetecteerd, bevat de respons ook details van de bestaande transactie (PayID, TransactionID, Datum, etc.).