La personnalisation de la page de paiement se fait avec l'objet template.
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 quipevent être personnalisées à l'aide des customfields.
| 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 |
| language | json |
|---|---|
| title | Exemple du paramètre name sur l'api /payments |
| linenumbers | true |
Liste des 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 | Numéro de facture |
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"
}
}
}
... |
CustomField14
Lorsque le paramètre 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"
}
},
... |
