Versions Compared

Old Version 1

changes.mady.by.user axpb-vanmeerbeek

Saved on

compared with

New Version 2

changes.mady.by.user axpb-vanmeerbeek

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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

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

Table of Contents



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 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. Upon completion, customer is redirected to the return URL that was submitted by you during Create checkout session call (urls.return) with payId in the query parameters.
  8. Browser fetches the return URL hosted by your backend.
  9. Backend makes a GET Payment details call with payId to retrieve the response code of the payment.
  10. Axepta BNP Paribas responds with the responseCode of the payment along with other parameters.
  11. Backend returns a success or a failure page based on the response code of the payment.

3. Create checkout session (step by step)

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 -aanroep naar Axepta BNP Paribas..

  3. Axepta BNP Paribas reageert met de doorverwijzings-URL naar uw backend.
  4. Uw backend zorgt ervoor dat de browser de gebruikersinterface doorverwijst naar de doorverwijzings-URL.
  5. De klant wordt doorgestuurd naar de gehoste betaalpagina van Axepta BNP Paribas.
  6. De klant selecteert de gewenste betaalmethode en voltooit de betaling.
  7. Na voltooiing wordt de klant doorgestuurd naar de return-URL die u tijdens de Create checkout session aanroep hebt opgegeven (urls.return), met payId in de queryparameters. 
  8. De browser haalt de return-URL op, gehost door uw backend.
  9. Backend doet een GET Payment details-aanroep met payId om de responscode van de betaling op te halen.
  10. Axepta BNP Paribas reageert met de responseCode van de betaling, samen met andere parameters.
  11. Backend toont een succes- of foutpagina op basis van de responscode van de betaling.


3. anmaken van een checkout-sessie (stap voor stap)

(Swagger documentatie van de (Swagger documentation of the /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

This includes the

  • -authenticatiestap. Dit omvat het token type

and

  • en JSON Web Token (JWT).

They must be specified in the


  • 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"

Minimal

Minimale Gegevens Data

To initiate payment, the minimum required data includes

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

  • 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 EUR-centen).
      • 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'
      functionalityOrder data
        • -functionaliteit.
      • Orderdata: '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
        • gegenereerd op de handelaarswebsite.
        • Het is aangeraden om beide te verstrekken.
      • Return-URL's
      Return URLs
      • : 'urls'-object
      Mandatory addresses for
      • .
        • Verplichte adressen voor 3 return
      URLs
        • -URL's: return, cancel, webhook.
    Code Block
    languagejson
    titleExample of minimal Voorbeeld van minimale create session curl
    linenumberstrue
    curl -i -X POST \
  https://test.paymentpage.axepta.bnpparibas/api/v2/payments/sessions \
  -H 'Authorization: <token_Type> <YOUR_JWT>' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: "8f35cb16-2f05-4aa1-85cf-b1e41ee7aec9" \
  -d '{
    "transId": "95330876-67ae-4949-a11c-b9a29257831b",
 	"amount": {
    	"currency": "EUR",
    	"value": 1500
    },
    "customerInfo": {
        "merchantCustomerId": "id-8803",
        "email": "john-doe@email.com"
    },
 	"order": {
    	"merchantReference": "order7811",
        "invoiceId": "invoice10240203569454"
    },
 	"urls": {
 		"return":"https://myProcessingServer.net/myApi/success.php?transId=95330876-67ae-4949-a11c-b9a29257831b",
		"cancel":"https://myProcessingServer.net/myApi/cancel.php?transId=95330876-67ae-4949-a11c-b9a29257831b",
 		"webhook":"https://myBackOfficeServer.net/webhook.php" 
    }
}

    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.

    Code Block
    languagejson
    titleResponse example
    linenumberstrue
    {
    "_links": {
        "redirect": {
            "href": "https://test.paymentpage.axepta.bnpparibas/paymentpage.aspx?token=eb577d2d61ba4396bfeb0de554e76a70",
            "type": "text/html"
        }
    }
}



    4.

     Recommendations

    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:


    6.

    Related features

    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.