Inleiding
Introduction
...
De dubbelcheck in
Axepta BNP Paribas Online
...
is ontworpen om dubbele betaalpogingen te detecteren en te beheren over meerdere kanalen (API, HPP, etc.).
It ensures that users and merchants do not accidentally trigger multiple payments with identical parameters, including cases where a payment is already in progress.
Objectives of Duplication check
Duplicates can originate from several causes :
User interaction errors (e.g., refresh, double-click, tab closure)
Merchant-side logic issues (e.g., retry loops)
Network latency or waiting times causing uncertainty about the payment status
Payment attempts still in progress when a new request is submitted
Configuration
The merchant must choose the following elements, which will be configured on the Axepta BNP Paribas Online side :
Historical depth in which duplicates are checked: 1 hour to 4 days (in hours)
- Historical depth refers to the period during which the system retains and analyzes past transaction data to detect duplicate payment attempts. This depth is configurable and can range from 1 hour to 4 days, depending on the merchant's needs and specific configurations. It allows comparing new transactions with those recorded within this timeframe to avoid redundant payments.
Scope: 1 or multiple MID
Consideration of "in progress" payments: yes/no
Operation
1. Verification
Duplicate checks are triggered before the payment page is displayed and between payment pages:
If a duplicate is detected, the user is redirected to the Failure URL
No payment is submitted if the request matches an existing or in-progress transaction
A failed transaction will not trigger duplicate detection.
2. Implementation
...
Het zorgt ervoor dat gebruikers 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 (HPP) 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 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.).