Streamline payment flows by directly integrating payment method selection into your website. The payment experience is hosted and managed by the payment method in its secure environment or by Axepta BNP Paribas for card payments.

Key Benefits

  • Design your own user interface/payment method selector

  • For card payments, customer-sensitive data remains entirely within the Axepta BNP Paribas system, significantly reducing your responsibilities and costs related to PCI-DSS compliance.

  • For other payment methods, the payment experience is managed by the payment method (e.g. PayPal).


Payment Flow

Hosted Payment Experience by Axepta BNP Paribas: Card Payment Form

Payment Method: Card

  1. The customer proceeds with the payment on your online store.

  2. Your frontend requests the payment page from the backend.

  3. Your backend makes a CreatePayment call with `paymentMethods.integrationType=HOSTED` to Axepta BNP Paribas.

  4. Axepta BNP Paribas responds with an HTTP 202 response code and a redirect URL to your backend.

  5. Your backend orchestrates the browser to redirect the user interface to the redirect URL.

  6. The customer is redirected to the payment form hosted by Axepta BNP Paribas.

  7. The customer enters the details and completes the payment.

  8. At the end, the customer is redirected to the return URL that you submitted during the payment creation call (urls.return) with the payId in the query parameters.

  9. The browser retrieves the return URL hosted by your backend.

  10. The backend makes a GET payment details call with the payId to retrieve the payment response code.

  11. Axepta BNP Paribas responds with the payment response code along with other parameters.

  12. Your backend returns a success or failure page based on the payment response code.




Hosted Payment Experience by Payment Methods



  1. The customer selects a payment method and proceeds with the payment on your online store.

  2. Your frontend requests the payment page from the backend.

  3. Your backend makes a CreatePayment call with `paymentMethods.integrationType=HOSTED` to Axepta BNP Paribas.

  4. Axepta BNP Paribas makes a payment request to the payment method.

  5. The payment method responds with a redirect URL.

  6. Axepta BNP Paribas responds with an HTTP 202 response code and a redirect URL to your backend.

  7. Your backend orchestrates the browser to redirect the user interface to the redirect URL.

  8. The customer is redirected to the payment form hosted by the APM provider.

  9. The customer enters the details and completes the payment.

  10. The payment method redirects the customer to the callback URL of Axepta BNP Paribas that was submitted in step 3.

  11. The browser requests the callback URL from Axepta BNP Paribas.

  12. Axepta BNP Paribas communicates with the APM provider to confirm the payment response code.

  13. At the end, the customer is redirected to the return URL that you submitted during the payment creation call (urls.return) with the payId in the query parameters.

  14. The browser retrieves the return URL hosted by your backend.

  15. The backend makes a GET payment details call with the payId to retrieve the payment response code.

  16. Axepta BNP Paribas responds with the payment response code along with other parameters.

  17. Your backend returns a success or failure page based on the payment response code.



Payment Methods

The list of payment methods compatible with this integration is available in the section: Payment Methods