Inleiding
De dubbelcheck in
Introduction
Duplication check in Axepta BNP Paribas Online is designed to detect and manage duplicate payment attempts across multiple channels 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 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 Option 1: Payment made via the Payment Method Selection Page (HPP) or Card Payment Form (payssl) It is necessary to add at least one of the following parameters in the API calls to /payments/sessions and /payments:
order.merchantReferenceorder.invoiceIdAmount(Bedrag)
Option Optie 2: Duplicate Verification Dubbelcheck via API – Coming Soon The Axepta Online API provides an endpoint allowing merchants to verify if a transaction is a duplicate before submitting itBinnenkort 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: coming soon
- binnenkort beschikbaar Parameter
- Parameters:
merchantReference or - of
invoiceId( required - verplicht),
Amount,Currency.
3.
...
Responsformaat
The De API returns a status indicating whether a transaction is a duplicate 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 | Multiple duplicates detected, additional criteria required |
| Meerdere dubbels gedetecteerd, extra criteria nodig |
Als een dubbel wordt gedetecteerd, bevat de respons ook details van de bestaande transactie (PayID, TransactionID, Datum If a duplicate is detected, the response also includes details of the existing transaction (PayID, TransactionID, Date, etc.).