De Axepta BNP Paribas Online API is een veilige oplossing ontworpen om de integratie van betalingen in uw e-commerceplatform te vereenvoudigen. Deze documentatie biedt alle technische informatie die nodig is om de API effectief te begrijpen, te configureren en te gebruiken.



Volledige API-documentatie: https://axeptabnpparibas-docs.redocly.app/


Presentatie van de API

Belangrijkste kenmerken

FunctieBeschrijving
RESTful-architectuurGebaseerd op REST-principes voor een voorspelbare en gebruiksvriendelijke interface.
Verhoogde beveiligingPCI-DSS-compliant met HTTPS (TLS 1.2 of hoger) voor veilige communicatie.
Uitgebreide documentatieGedetailleerde technische handleidingen voor eenvoudige integratie.

Gebruiksscenario's

  • Online betalingen – Verwerk betalingen in real-time. 
  • Transactiebeheer – Raadpleeg en beheer eerdere transacties (bv. terugbetalingen, annuleringen).
Authenticatie 

Ondersteunde authenticatiemethoden

Authenticatie verloopt via de productie-API: https://paymentpage.axepta.bnpparibas/

De API ondersteunt twee authenticatiemethoden:

  • BasicAuth (eenvoudig, maar minder veilig)
  • OAuth 2.0 (aanbevolen)

OAuth 2.0 :

Authenticatie moet plaatsvinden via het OAuth-V2-protocol. 

Stappen:

  1. Genereer een JSON Web Token (JWT) door te authenticeren met uw API-sleutel via het endpoint: authorization/oauth/token
  2. Het access_token en token_type moeten worden meegestuurd in elke serveraanvraag, in de HTTP-header Authorization.

Voorbeeld van een JWT-response:

{
  "access_token": "eyJhbGciOiJSUzI1NiIsImtpZCI6IkZGQzlEM0JEQzY2Mjc3MUYwNzYxRUJDRTkwOTMyMDMyQjdGOTQ1NTQiLCJ4NXQiOiJfOG5UdmNaaWR4OEhZZXZPa0pNZ01yZjVSVlEiLCJ0eXAiOiJhdCtqd3QifQ.eyJpc3MiOiJodHRwczovL2xvY2FsaG9zdDo3MTIxLyIsImV4cCI6MTc0MDQ3NTUwNCwiaWF0IjoxNzQwNDcxOTA0LCJqdGkiOiJiZjU3YmUwMi05YThiLTQxYjctYjNjNi02NzlmMTcxNDU2ZjAiLCJzdWIiOiJDVF9Mb2dlZWNvbV90ZXN0IiwibmFtZSI6IkNUX0xvZ2VlY29tX3Rlc3QiLCJtYXJrZXRwbGFjZUlkIjoiQ1RfTG9nZWVjb21fdGVzdF9NYXJrZXRwbGFjZSIsIm1hcmtldHBsYWNlQWN0aXZlIjpmYWxzZSwib2lfcHJzdCI6IkNUX0xvZ2VlY29tX3Rlc3QiLCJjbGllbnRfaWQiOiJDVF9Mb2dlZWNvbV90ZXN0Iiwib2lfdGtuX2lkIjoiMjEwMWUxNTgtNzY0NC00OGU4LWIzNmYtYmZhNzczNWJmYjAyIn0.Xgtb81-GBPGnQ2tSJKXIlA38koRqlVa2oLhT902t-ICocWYD4_35bTAiPfU2A4HWwQpg1PZTrdf4riSoA_v_5bWSM-rdHAb-Y7fNwQTYAUYDxkcrw9qc5JcjwBGlOgXGTzJR2xyPDTq2sO4qAxo00lhCVjhEQR47yqOFta9rkcCmg1i6T6BxF7ZO6tBECfo7NSJ0wgN7G5_Unmd5MgWuG8V5VdvDxhXa1p_sBQdmy6nBCRi2d2bh1BOrz_uT5U2zngVBPzZBXv046j7971JXZbR20JFpkqwrULCGR6fy78NvkrHNC4U8ZDHmbejBbObMGCb_8pWMnaLhIg0A1k2x0Q",
  "token_type": "Bearer",
  "expires_in": 3600
}


⚠ Belangrijk:

  • Het toegangstoken is 1 uur geldig.
  • Na verloop van tijd moet u opnieuw authenticeren om een nieuw token te verkrijgen.


Idempotentie voor POST en PATCH-verzoeken

Idempotentie voor POST en PATCH-verzoeken
Voor POST en PATCH-verzoeken wordt idempotentie gegarandeerd door de HTTP-header Idempotency-Key.

Vereisten:

  • De waarde moet uniek zijn voor elk HTTP-verzoek.
  • De client is verantwoordelijk voor het genereren van deze sleutel.
  • Aanbevolen formaat: UUID v4 (bv. 123e4567-e89b-12d3-a456-426614174000).