Initier une demande de paiement pour la prise de commande
La demande de paiement s’initie via l’appel au Web Service Charge/CreatePayment.
Le choix de faire du paiement à l’expédition se fait lors de la demande de paiement effectuée à la prise de commande. Il consiste à créer la transaction dite initiale.
La demande de paiement engendre une transaction de type Vérification si le cas d’utilisation Paiement à l’expédition est transmis dans la requête.
En réponse, le serveur marchand récupère un formToken, un objet encrypté permettant d’initialiser le formulaire avec les informations de la transaction et celles correspondant à la configuration de boutique.
Utilisez les champs ci-dessous pour construire la requête :
| Nom du champ | Description | Requis |
|---|---|---|
| formAction | Type de comportement souhaité lors de la création
de la transaction. Doit être valorisé à PAYMENT. Le formulaire intelligent (smartForm) est compatible avec un wallet (en intégrant le champ formAction avec la valeur CUSTOMER_WALLET) uniquement en "Mode liste" ou en "Mode pop-in". | Non |
| amount | Montant à payer, exprimé dans sa plus petite unité monétaire (le centime pour l’euro). | Oui |
| currency | Devise du paiement. Code ISO 4217 alpha-3. Ex: “EUR” pour l’euro | Oui |
| orderId | Référence de la commande. | Non |
| useCase | Permet de spécifier un paiement à l’expédition avec autorisations multiples. Valeur attendue : SHIPMENT_MULTIPLE_AUTHORISATION | Non |
| ipnTargetUrl | Permet de surcharger l’URL de notification instantanée (également appelée IPN) dans le formulaire. | Non |
| paymentMethods | Liste des moyens de paiement à proposer à l’acheteur. | Non |
| customer.email | Adresse e-mail qui sera utilisée pour l’envoi du ticket de paiement à l’acheteur. | Non |
| customer.reference | Identifiant de l’acheteur sur le site marchand. | Non |
| customer.billingDetails.firstName | Prénom de l’acheteur. | Non |
| customer.billingDetails.lastName | Nom de l'acheteur. | Non |
| customer.billingDetails.phoneNumber | Numéro de téléphone de l’acheteur. | Non |
| customer.billingDetails.address | Adresse de l’acheteur. | Non |
| customer.billingDetails.zipCode | Code postal. | Non |
| customer.billingDetails.city | Ville. | Non |
Pour obtenir une description plus complète des champs à utiliser, testez le Web Service Charge/CreatePayment depuis notre playground.
Exemple de requête
https://api.scelliuspaiement.labanquepostale.fr/api-payment/V4/Charge/CreatePayment
{
"amount": 7412,
"currency": "EUR",
"customer": {
"email": "sample@example.com"
},
"orderId": "myOrderId-385432",
"useCase": "SHIPMENT_MULTIPLE_AUTHORISATION"
}