Page History

De betaalpagina van Axepta BNP Paribas wordt gebruikt wanneer een handelaar een volledige en gepersonaliseerde betaalervaring aan klanten wil aanbieden. Deze oplossing is ideaal voor e-commercewebsites die een veilige betaaloplossing willen integreren die voldoet aan de huidige normen.

Deze integratie vereist minimale ontwikkelingsinspanning, ondersteunt meerdere betaalmethoden in één implementatie en zorgt ervoor dat gevoelige klantgegevens volledig binnen de systemen van Axepta BNP Paribas blijven. Door de betalingsverwerking uit te besteden, vermindert uw bedrijf aanzienlijk de verantwoordelijkheden en kosten met betrekking tot PCI-DSS-naleving.

Samenvatting

1. Belangrijkste voordelen

• Geoptimaliseerde gebruikerservaring: Bied uw klanten een intuïtieve, veilige en responsieve betaalinterface.
  Minimale ontwikkelingsinspanning: Ondersteun meerdere betaalmethoden in één implementatie.
  Naleving van normen: Voldoen aan de huidige regelgeving via het beheer van gevoelige klantgegevens door Axepta BNP Paribas, waardoor uw PCI-DSS-verantwoordelijkheden en -kosten aanzienlijk worden verminderd.

2. Betaal Flow

Image Added

De klant gaat naar de kassa op uw webshop. 

1. Uw frontend vraagt de betaalpagina aan bij de backend.

2. Uw backend doet een Create checkout session -oproep naar

The payment page hosted by Axepta BNP Paribas is used when a merchant wants to offer a complete and customized payment experience to their customers. This method is ideal for e-commerce sites that want to integrate a secure payment solution compliant with current standards.

This integration requires minimal development effort, supports multiple payment methods under a single implementation, and ensures that customer sensitive data remains entirely within Axepta BNP Paribas systems. By outsourcing payment processing, your business significantly reduces responsibilities and costs related to PCI-DSS compliance.

Summary

1. Key Advantages

• Optimized User Experience: Provide your customers with an intuitive, secure, and responsive payment interface

• Minimal Development Effort: Offer multiple payment methods under a single implementation

• Compliance with Standards: Comply with current regulations through Axepta BNP Paribas's management of customer sensitive data, significantly reducing your PCI-DSS compliance responsibilities and costs

2. Payment Flow

Image Removed

 Customer proceeds to checkout on your online store.

1. Your frontend requests the payment page to the backend.

2. Your backend makes a Create checkout session call to Axepta BNP Paribas.

3. Axepta BNP Paribas responds with the redirect URL to your reageert met de doorverwijzings-URL naar uw backend.
4. Your backend orchestrates the browser to redirect the User Interface to the redirect URL.
5. Customer is redirected to Hosted payment page hosted by Axepta BNP Paribas.
6. Customer selects its preferred payment method and completes payment.
7. Uw backend zorgt ervoor dat de browser de gebruikersinterface doorverwijst naar de doorverwijzings-URL.
8. De klant wordt doorgestuurd naar de gehoste betaalpagina van Axepta BNP Paribas.
9. De klant selecteert de gewenste betaalmethode en voltooit de betaling.
10. Na voltooiing wordt de klant doorgestuurd naar de return-URL die u tijdens de Create checkout session oproep hebt opgegeven Upon completion, customer is redirected to the return URL that was submitted by you during Create checkout session call (urls.return) with , met payId in the query parametersde queryparameters. 
11. De browser haalt de return-URL op, gehost door uw Browser fetches the return URL hosted by your backend.
12. Backend makes a doet een GET Payment details call with payId to retrieve the response code of the payment-oproep met payId om de responscode van de betaling op te halen.
13. Axepta BNP Paribas responds with the responseCode of the payment along with other reageert met de responseCode van de betaling, samen met andere parameters.
14. Backend returns a success or a failure page based on the response code of the paymenttoont een succes- of foutpagina op basis van de responscode van de betaling.

3.

(Swagger documentation of the Documentatie van de /payment/session API: Create checkout session )

Technische Verbindingsgegevens

Technische verbindingsgegevens moeten worden meegegeven in de HTTP-headers van de REST-aanvraag

Technical Connection Data

Technical connection data must be passed in the HTTP headers of the REST request:

• Content-Type

The payload type: data must be passed in a JSON payloadhet type payload; gegevens moeten in een JSON-payload worden meegegeven.

Content-Type: application/json

• Authorization data received during the Autorisatiegegevens, ontvangen tijdens de OAuth-v2 authentication step

• -authenticatiestap. Dit omvat het token type

• en JSON Web Token (JWT).

• 
  Deze moeten worden gespecificeerd in de 'Authorization'-header. 

Authorization: <token_type> <YOUR_JWT>

• Idempotency Idempotentie ID

Essential for detecting possible HTTP repetitions.

Essentieel voor het detecteren van mogelijke HTTP-herhalingen.

Gebruik de Use the 'Idempotency-Key' header and generate a -header en genereer een uuid-v4 as the valueals waarde. 

Idempotency-Key: "8f35cb16-2f05-4aa1-85cf-b1e41ee7aec9"

Minimale Gegevens

Om een betaling te starten, zijn de volgende minimale gegevens vereist

Minimal Data

To initiate payment, the minimum required data includes:

• Merchant-side transaction identifier: 'transId'
  The amount and currency of the transaction
  • • Het bedrag en de valuta van de transactie: 'amount'
  objectComposed of
  • • -object, bestaande uit 'currency'
  and
  • • en 'value'
  data
  • The amount must always be expressed in the smallest unit of the transaction currency (e.g., EUR cents)
  • • .
    • Het bedrag moet altijd worden uitgedrukt in de kleinste eenheid van de transactievaluta (bijvoorbeeld eurocenten).
  • Klantidentificatie
  Customer identification
  • : 'customerInfo'-object
  At minimum, the customer's email
  • .
    • Minimaal het e-mailadres van de klant: 'email'.
  It is highly recommended to provide customer identification on the merchant website
  • • Het is sterk aangeraden om ook de klantidentificatie op de handelaarswebsite mee te geven: 'merchantCustomerId'.
  This
  • • Deze data is
  essential for the
  • • essentieel voor de 'One-Click'
  functionality
  • • -functionaliteit.
  • Orderdata
  Order data
  • : 'order'-object
  At least one of the following: order number
  • .
    • Minimaal één van de volgende: ordernummer 'merchantReference'
  or invoice number
  • • of factuurnummer 'invoiceId'
  generated on the merchant website
  • It is recommended to provide both
  Return URLs
  • • gegenereerd op de handelaarswebsite.
    • Het is aangeraden om beide te verstrekken.
  • Return-URL's: 'urls'-object
  Mandatory addresses for
  • .
    • Verplichte adressen voor 3 return
  URLs
  • • -URL's: return, cancel, webhook.

Response and redirect to the payment page

Respons en doorverwijzing naar de betaalpagina

U zou een HTTP 202-respons moeten ontvangen die aangeeft dat de transactieverwerking is gestart en dat er een betalingscontext op de server is gemaakt.

De responsbody bevat de link naar de betaalpagina die gehost wordt op het Axepta BNP Paribas Online-platform.

U moet de browser van de klant doorverwijzen naar deze

You should receive an HTTP 202 response message indicating that transaction processing has been initiated and that a payment context has been created on the server.

The response body contains the link to the payment page hosted on the Axepta BNP Paribas Online platform.

You must redirect the customer's browser to this link.

4.

Aanbevelingen

We raden aan om minstens de volgende gegevens door te sturen:

• Transactie-identifier: de unieke betalingsidentifier
• Betaalbedrag: het bedrag dat de klant moet betalen
• Valuta: de valuta gebruikt voor de betaling
• Klantidentifier: de unieke klantidentifier
• E-mail: het e-mailadres van de klant
• Orderidentifier

We recommend transmitting at least the following data:

• Transaction Identifier: The unique payment identifier
• Payment Amount: The amount to be paid by the customer.
• Currency: The currency used for the payment.
• Customer Identifier: The unique customer identifier
• Email: The customer's email
Order Identifier
• (order.merchantReference):
The order identifierInvoice Identifier
• de orderidentifier
• Factuuridentifier (order.invoiceId):
The invoice identifier associated with this payment

Our complete guidelines are available here: Integration recommendation

5. Available payment methods

• de factuuridentifier gekoppeld aan deze betaling

Onze complete richtlijnen zijn beschikbaar: Integratieaanbevelingen

5. Beschikbare betaalmethoden

We bieden de volgende betaalmethoden, afgestemd op uw specifieke behoeften en die van uw klantenWe offer the following payment methods tailored to your specific needs as well as those of your customers:

• Cards
  • MasterCard
  • Visa
• Bancontact
• Wallets
  • Apple Pay
  • Google Pay
• Paypal
• Wero

6.

Gerelateerde functies

• Automatische generatie van endAutomatic Generation of End-to-end-End Reference referentie (RefNr): Each transaction is assigned a unique automatically generated reference.
Duplication Control: Detect and manage duplicate payment attempts to prevent errors - Enabled during your store configuration or via a support request
• elke transactie krijgt een unieke, automatisch gegenereerde referentie.
• Duplicaatcontrole: detecteert en beheert dubbele betaalpogingen om fouten te voorkomen. Deze functie is beschikbaar tijdens de configuratie van uw webshop of via een supportverzoek.