View Source

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.merchantReference
order.invoiceId
Amount (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: merchantReference of invoiceId (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.).