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

In deze sectie vindt u:

Table of Contents

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.

Kaartbetalingsformulier 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<br>integratie

- Minimale ontwikkeling aan handelaarszijde

- Koper blijft in een bekende en vertrouwde omgeving<br>

- 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

Code Block

language	json

"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 methodenbetaalmethoden beperken via de parameter: 'allowedPaymentMethods'.

Code Block

language	json

 "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

kaartbetalingsformulier

kaartbetaalformulier (Payssl)

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

Code Block

language	json
theme	Confluence

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

Beschikbare kaarten:

Kaart	API-waarde
Visa	VISA
MasterCard	MASTERCARD

Aanpasbare velden (CustomFields) op betaalpagina’s

List of customFields

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"

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

Code Block

language	json
title	Voorbeelden van CustomFields in API-aanroepen
linenumbers	true

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

Code Block

language	json
title	Example with the customFields on the /payments API
linenumbers	true

...
"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 Kaartbetalingsformulier Kaartbetaalformulier (/payments):

Implementatie van iframe (customField14)

Hosted Payment Page in iframe (op handelaarsite)

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

Code Block

language	json
title	Voorbeelden van customFields in API /payments/sessions
linenumbers	true

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

Example of Voorbeeld van een Hosted Payment Page with the met customField14

Display of the card payment form

Weergave van het kaartbetaalformulier (Payssl)

on the merchant site

op de webshop van de handelaar (iframe)

When the Wanneer de parameter customField14 = "iframe" is set on the Hosted Payment Page, all other custom fields become invisible, except for customField1ingesteld, worden alle andere custom fields verborgen, behalve customField1.

Code Block

language	json
title	Exemple d'objet customFields sur l'API /payments
linenumbers	true

...
"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: Kaartbetalingsformulier Kaartbetaalformulier (Payssl) met customField14

Page tree

Versions Compared

Old Version 2

New Version Current

Key

Axepta BNP Paribas Online betaalpagina’s

Keuze betaalervaring

Dynamische instellingen betaalpagina

Talen betaalpagina

Weergave betaalmethoden op de Hosted Payment Page

Weergave betaalmethoden op het

kaartbetaalformulier (Payssl)

Aanpasbare velden (CustomFields) op betaalpagina’s

Lijst van CustomFields

Implementatie van iframe (customField14)

Hosted Payment Page in iframe (op handelaarsite)

Weergave van het kaartbetaalformulier (Payssl)

op de webshop van de handelaar (iframe)

Help

Intranet Tools

Page tree

Page History

Versions Compared

Old Version 2

New Version Current

Key

Axepta BNP Paribas Online betaalpagina’s

Keuze betaalervaring

Dynamische instellingen betaalpagina

Talen betaalpagina

Weergave betaalmethoden op de Hosted Payment Page

Weergave betaalmethoden op het

kaartbetaalformulier (Payssl)

Aanpasbare velden (CustomFields) op betaalpagina’s

Lijst van CustomFields

Implementatie van iframe (customField14)

Hosted Payment Page in iframe (op handelaarsite)

Weergave van het kaartbetaalformulier (Payssl)

op de webshop van de handelaar (iframe)