La personnalisation de la page de paiement se fait avec l'objet template.
Le paramètre 'name', donne au marchand la possibilité d'utiliser un template personnalisé.
Avec les customfields, le marchand peut utiliser les champs personnalisables pouvant stocker des données supplémentaires ou afficher des informations spécifiques sur une page de paiement.
A chaque page de paiement, un template
Il existe 2 types de pages de paiement AXEPTA sur lesquelles un template personnalisé peut être ajouté.
| Nom | API | Templates Standard AXEPTA | Templates Personnalisés Marchands (Ex : BNP_DEMO_AXEPTA) |
|---|---|---|---|
| Formulaire de choix des moyens de paiement (hosted payment page) | /payments/sessions | BNP_Paribas_Group_test_system_SelectionListVAXEPTA | BNP_Paribas_Group_test_system_SelectionListVDEMO |
Formulaire de paiement par carte (Payssl) | /payments | BNP_Paribas_Group_test_system_CardsVAXEPTA | BNP_Paribas_Group_test_system_CardsVDEMO |
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
...
"template": {
"name": "BNP_Paribas_Group_test_system_SelectionListVAXEPTA"
}
... |
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
...
"paymentMethods": {
"integrationType": "HOSTED",
"type": "CARD",
"card": {
"template": {
"name": "BNP_Paribas_Group_test_system_CardsVAXEPTA"
}
}
}
... |
Objet customFields
Paramètre | Format | CND | Description |
|---|---|---|---|
template.customFields.customField1 | ans...50 | O | Montant et devise du paiement |
template.customFields.customField2 | ans...50 | O | Numéro de commande |
template.customFields.customField3 | ans...256 | O | Logo du commerçant URL avec le logo du commerçant, taille recommandée 200x100 pixels |
template.customFields.customField4 | ans...50 | O | Panier / description de la commande |
template.customFields.customField5 | ans...50 | O | Informations sur l'utilisateur |
template.customFields.customField6 | ans...50 | O | Adresse de livraison |
template.customFields.customField7 | ans...50 | O | Adresse de facturation |
template.customFields.customField8 | ans...50 | O | Nom du champ (header) personnalisable (à la main du commerçant) |
template.customFields.customField9 | ans...50 | O | Valeur du champ personnalisable (relatif au champ 8) |
template.customFields.customField14 | ans...50 | O | Cette option permet de mettre en place l'iframe dans la page de paiement du marchand. |
| Info |
|---|
Les customFields permettent d'afficher du texte avec retour à la ligne. Dans ce cas, il est nécessaire d'ajouter le caractère "|" dans le contenu du customField pour indiquer le retour à ligne. Exemple : CustomField6 = Ligne 1|Ligne 2|Ligne 3 Les CustomField qui acceptes "|" sont CustomField4, CustomField5, CustomField6, CustomField7 et CustomField9 |
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
...
"template": {
"customFields": {
"customField1": "15.00 EURO",
"customField2": "merchantReference",
"customField3": "https://placehold.co/200x100/png",
"customField4": "invoiceId",
"customField5": "+3300000000|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"
}
},
... |
Exemple de formulaire de choix des moyens de paiement (hosted payment page) contenant des customFields
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
...
"paymentMethods": {
"integrationType": "HOSTED",
"type": "CARD",
"card": {
"template": {
"customFields": {
"customField1": "15.00 EURO",
"customField2": "merchantReference",
"customField3": "https://placehold.co/200x100/png",
"customField4": "invoiceId",
"customField5": "+3300000000|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 de formulaire de paiement par carte (Hosted payment form)
CustomField14
Lorsque customField14 = "iframe", tous les autres champs personnalisés deviennent invisibles, à l'exception du customField1.
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
... "template": {
"customFields": {
"customField1": "15.00 EURO",
"customField2": "merchantReference",
"customField3": "https://placehold.co/200x100/png",
"customField4": "invoiceId",
"customField5": "+3300000000|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"
}
},
... |
