This section details the features related to the Axepta BNP Paribas Online payment page: page type, integration methods, customization options.
This section contains:
Axepta BNP Paribas Online payment pages
The Axepta BNP Paribas Online solution offers 2 payment pages:
Pages de paiement BNP Paribas payment page: | ||
|---|---|---|
Payment pages | Payment Page Hosted by Axepta BNP Paribas (Hosted Payment Page) Display of all payment means that the merchant wishes to offer. | Card Payment Form (Payssl) Card payment only display |
Endpoint | /payments/sessions | /payments (card) |
Customization |
| |
Payment experience selection
The merchant can choose between the 2 following payment experiences:
Option | Redirection | iFrame |
|---|---|---|
Overviews |
|
|
Operation | The buyer is redirected to the Axepta BNP Paribas Online payment page. | The buyer remains on the merchant's site and the Axepta BNP Paribas Online payment page is displayed within the merchant's site. |
Assets |
|
|
Dynamic payment page settings
Payment page languages
The payment page is available in French and English.
If the language is not specified in the API call, then the payment page language corresponds to the browser language.
If the browser language is not available on the payment page, then the payment page is displayed in English.
The user has the option to change the language, once on the payment page thanks to a drop-down menu, at the top right of it.
API call
"language": "fr"
Available languages
| Language | Value in the API |
|---|---|
| French | fr |
| English | en |
| Dutch | nl |
Display of payment methods on the payment method selection page (Hosted Payment Page)
By default, all available payment methods on the MerchantID are displayed on the payment method selection page.
The merchant has the possibility to restrict and control the payment means displayed to a customer via the 'allowedPaymentMethods' parameter.
"allowedPaymentMethods" : [
"PAYPAL",
"WERO",
"CARD"
],
Available payment means
Payment Method | Parameter Value for "allowedPaymentMethods" in API Call to /payments/sessions |
Card *See below the list of card brands | CARD |
WERO | WERO |
APPLEPAY | APPLEPAY |
| GOOGLEPAY | GOOGLEPAY |
| PAYPAL | PAYPAL |
| FLOAPAY | FLOAPAY |
BANCONTACT | BANCONTACT |
INSTANEA | INSTANEA |
Display of payment methods on the card payment form (Payssl)
By default, all available payment methods on the MerchantID are displayed on the payment method selection page.
The merchant has the possibility to restrict and control the card(s) displayed to a customer via the parameter 'paymentMethods.card.subType'.
"paymentMethods": {
"card" : {
...
"subType" : ["CARTESBANCAIRES", "VISA","MASTERCARD", "AMEX"],
...
},
Available cards
This table lists the exact spelling of different card brands to be specified in the subType parameter of paymentMethods.card objects:
| Card | Value in the API |
Carte CB | CARTESBANCAIRES |
Visa | VISA |
MasterCard | MASTERCARD |
| Amex | AMEX |
JCB | JCB |
Discover | DISCOVER |
Diners | DINERS |
UnionPay International (UPI) | CUP |
Customizable fields on payment pages
List of customFields
When the merchant decides to use BNP Paribas' standard page, he can insert its own logo and customizes specific fields called dynamic or customizable fields (customFields).
Parameter | Format | CND | Description |
|---|---|---|---|
template.customFields.customField1 | ans...50 | O | Amount and Currency |
template.customFields.customField2 | ans...50 | O | Order Reference |
template.customFields.customField3 | ans...256 | O | Merchant Logo Merchant Logo URL (recommended size: 200x100 pixels) |
template.customFields.customField4 | ans...50 | O | Invoice Reference |
template.customFields.customField5 | ans...50 | O | User Information |
template.customFields.customField6 | ans...50 | O | Delivery Address |
template.customFields.customField7 | ans...50 | O | Billing Address |
template.customFields.customField8 | ans...50 | O | Customizable Field Name (header) (merchant-defined) |
template.customFields.customField9 | ans...50 | O | Custom Field Value (related to field 8) |
template.customFields.customField14 | ans...50 | O | This option enables the iframe implementation in the merchant's payment page Accepted value: "iframe" |
The customFields allow displaying text with line breaks. In this case, you need to add the character "|" in the customField content to indicate a line break.
Example: CustomField6 = Line 1|Line 2|Line 3
The customFields that accept the "|" character are CustomField4, CustomField5, CustomField6, CustomField7, and CustomField9.
...
"template": {
"customFields": {
"customField1": "20.00 €",
"customField2": "merchantReference",
"customField3": "https://placehold.co/200x100/png",
"customField4": "invoice29351925733931",
"customField5": "+33600000000|john.doe@bnpparibas.com",
"customField6": "41 Rue de Valmy|93100 Montreuil",
"customField7": "41 Rue de Valmy|93100 Montreuil",
"customField8": "Discount",
"customField9": "FRI_50|SUM_25"
}
},
...
Example of Hosted Payment Page with customFields
...
"paymentMethods": {
"type": "CARD",
"card": {
"template": {
"customFields": {
"customField1": "20.00 €",
"customField2": "merchantReference",
"customField3": "https://placehold.co/200x100/png",
"customField4": "invoice29351925733931",
"customField5": "+33600000000|john.doe@bnpparibas.com",
"customField6": "41 Rue de Valmy|93100 Montreuil",
"customField7": "41 Rue de Valmy|93100 Montreuil",
"customField8": "Discount",
"customField9": "FRI_50|SUM_25"
}
}
}
}
...
Example of Card Payment form with customFields
Implementation of the iframe (customField14)
Display of the payment method selection page (Hosted Payment Page) on the merchant site (iframe)
When the parameter customField14 = "iframe" is set on the Hosted Payment Page, all other custom fields become invisible.
... "template": {
"customFields": {
"customField1": "20.00 EURO",
"customField2": "merchantReference",
"customField3": "https://placehold.co/200x100/png",
"customField4": "invoiceId",
"customField5": "+33600000000|john.doe@bnpparibas.com",
"customField6": "41 Rue de Valmy|93100 Montreuil",
"customField7": "41 Rue de Valmy|93100 Montreuil",
"customField8": "Discount",
"customField9": "FRI_50|SUM_25",
"customField14": "iframe"
}
},
...
Example of Hosted Payment Page with the customField14
Display of the card payment form (Payssl) on the merchant site (iframe)
When the parameter customField14 = "iframe" is set on the Hosted Payment Page, all other custom fields become invisible, except for customField1.
...
"paymentMethods": {
"integrationType": "HOSTED",
"type": "CARD",
"card": {
"template": {
"customFields": {
"customField1": "20.00 €",
"customField2": "merchantReference",
"customField3": "https://placehold.co/200x100/png",
"customField4": "invoice29351925733931",
"customField5": "+33600000000|john.doe@bnpparibas.com",
"customField6": "41 Rue de Valmy|93100 Montreuil",
"customField7": "41 Rue de Valmy|93100 Montreuil",
"customField8": "Discount",
"customField9": "FRI_50|SUM_25",
"customField14": "iframe"
}
}
}
...
Example of Card Payment form with the customField14
