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 |
| |
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):
...
"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):
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
