Deze sectie beschrijft de functionaliteiten met betrekking tot de Axepta BNP Paribas Online betaalpagina: paginatype, integratiemethoden en aanpassingsmogelijkheden.

In deze sectie vindt u:

Axepta BNP Paribas Online betaalpagina’s

De Axepta BNP Paribas Online-oplossing biedt 2 betaalpagina’s aan:

Axepta BNP Paribas betaalpagina’s

Betaalpagina’s

Betaalpagina gehost door Axepta BNP Paribas (Hosted Payment Page)

Weergave van alle betaalmiddelen die de handelaar wenst aan te bieden.

Kaartbetaalformulier (Payssl)

Uitsluitend weergave voor kaartbetalingen

Endpoint

/payments/sessions

/payments (card)

Customization

Dynamische parameters (talen, betaalmethoden)
Aanpasbare velden (CustomFields): orderdetails, kopergegevens, enz. & Logo

Keuze betaalervaring

De handelaar kan kiezen tussen 2 betaalervaringen:

Optie

Hosted Payment Page (omgeleid)

Ingebed in handelaarsite (iframe)

Overzicht

Werking

Koper wordt doorgestuurd naar de Axepta BNP Paribas Online betaalpagina.

Koper blijft op de site van de handelaar; de betaalpagina wordt ingebed weergegeven.

Voordelen

- Eenvoudigste integratie

- Minimale ontwikkeling aan handelaarszijde

- Koper blijft in een bekende en vertrouwde omgeving

- Vloeiende betalingsstroom

Dynamische instellingen betaalpagina

Talen betaalpagina

De betaalpagina is beschikbaar in:

Frans (fr)
Engels (en)
Nederlands (nl)

Logica taalselectie:

Bij het eerste bezoek:
- Als de taal niet is gespecificeerd in de API-aanroep, wordt de browsertaal gebruikt.
- Als de browsertaal niet beschikbaar is, wordt Engels als standaard weergegeven.
De koper kan de taal handmatig wijzigen via een keuzemenu (rechtsboven).
- De gekozen taal wordt opgeslagen voor volgende bezoeken.

API call

"language": "en"

Beschikbare talen

Taal	Parameterwaarde in API
Frans	fr
Engels	en
Nederlands	nl

Weergave betaalmethoden op de Hosted Payment Page

Standaard worden alle beschikbare betaalmethoden voor de MerchantID getoond. De handelaar kan de weergegeven betaalmethoden beperken via de parameter: 'allowedPaymentMethods'.

 "allowedPaymentMethods" :  [
      "PAYPAL",
      "CARD"
    ],

Beschikbare betaalmethoden:

Betaalmethode	Parameterwaarde in API (`/payments/sessions`)
Card *See below the list of card brands	CARD
BANCONTACT	BANCONTACT
PAYPAL	PAYPAL
APPLEPAY*	APPLEPAY*
GOOGLEPAY*	GOOGLEPAY*
WERO*	WERO*

*In ontwikkeling, binnenkort beschikbaar.

Weergave betaalmethoden op het kaartbetaalformulier (Payssl)

Standaard worden alle beschikbare kaartmerken voor de MerchantID getoond. De handelaar kan de getoonde kaartmerken beperken via de parameter 'paymentMethods.card.subType'.

"paymentMethods": {
        "card" : {
			...
            "subType" : ["VISA","MASTERCARD"],
			...
        },

Beschikbare kaarten:

Kaart	API-waarde
Visa	VISA
MasterCard	MASTERCARD

Aanpasbare velden (CustomFields) op betaalpagina’s

Lijst van CustomFields

Wanneer de handelaar de standaardpagina van Axepta BNP Paribas gebruikt, kan hij:

Een eigen logo toevoegen.
Dynamische velden (CustomFields) aanpassen (bv. orderdetails, koperinformatie).

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...255	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"

Regelafbreking in tekstvelden wordt aangegeven met |. Voorbeeld: customField6 = "Regel 1|Regel 2|Regel 3"
Velden die | ondersteunen: customField4, customField5, customField6, customField7, customField9.

...
	"template": {
        "customFields": {
            "customField1": "0.71 €",
			"customField2": "invoice7882181823303",
			"customField4": "order292322497021792",
            "customField5": "+33600000000|john.doe@bnpparibas.com",
			"customField6": "41 Rue de Valmy|93100 Montreuil",
            "customField7": "41 Rue de Valmy|93100 Montreuil",
        }
	},
...

Voorbeelden van CustomFields in Hosted Payment Page (/payments/sessions):

Axepta BNP Paribas Online - Benelux > Aanpassing van de afrekenervaring > image-2026-7-8_10-5-59-1.png

...
"paymentMethods": {
        "type": "CARD",
        "card": {
            "template": {
        		 "customFields": {
                   "customField1": "0.71 €",
					"customField2": "invoice7882181823303",
					"customField4": "order292322497021792",
            		"customField5": "+33600000000|john.doe@bnpparibas.com",
					"customField6": "41 Rue de Valmy|93100 Montreuil",
            }
       }
    }
}
...

Voorbeelden van CustomFields in Kaartbetaalformulier (/payments):

Axepta BNP Paribas Online - Benelux > Aanpassing van de afrekenervaring > image-2026-7-8_9-56-44.png

Implementatie van iframe (customField14)

Hosted Payment Page in iframe (op handelaarsite)

Wanneer customField14 = "iframe" is ingesteld, verdwijnen alle andere CustomFields (behalve customField1).

...	"template": {
        "customFields": {
					"customField1": "0.71 €",
					"customField2": "invoice7882181823303",
					"customField4": "order292322497021792",
            		"customField5": "+33600000000|john.doe@bnpparibas.com",
					"customField6": "41 Rue de Valmy|93100 Montreuil",
            		"customField14": "iframe"
        }
	},
...

Voorbeeld van een Hosted Payment Page met customField14

Weergave van het kaartbetaalformulier (Payssl) op de webshop van de handelaar (iframe)

Wanneer de parameter customField14 = "iframe" is ingesteld, worden alle andere custom fields verborgen, behalve customField1.

...
"paymentMethods": {
        "integrationType": "HOSTED",
        "type": "CARD",
        "card": {
            "template": {
        		 "customFields": {
           		 	"customField1": "0.71 €",
					"customField2": "invoice7882181823303",
					"customField4": "order292322497021792",
            		"customField5": "+33600000000|john.doe@bnpparibas.com",
					"customField6": "41 Rue de Valmy|93100 Montreuil",
                    "customField14": "iframe"
            }
       }
    }
...

Voorbeeld: Kaartbetaalformulier (Payssl) met customField14