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 | |
|---|---|---|
| formAction | Type de comportement souhaité lors de la création
de la transaction. Doit être valorisé à PAYMENT. | |
| amount | Montant à payer, exprimé dans sa plus petite unité monétaire (le centime pour l’euro). | |
| currency | Devise du paiement. Code ISO 4217 alpha-3. Ex: “EUR” pour l’euro | |
| orderId | Référence de la commande. | |
| 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. | |
| paymentMethods | Liste des moyens de paiement à proposer à l’acheteur. | |
| customer.email | Adresse e-mail qui sera utilisée pour l’envoi du ticket de paiement à l’acheteur. | |
| customer.reference | Identifiant de l’acheteur sur le site marchand. | |
| customer.billingDetails.firstName | Prénom de l’acheteur. | |
| customer.billingDetails.lastName | Nom de l'acheteur. | |
| customer.billingDetails.phoneNumber | Numéro de téléphone de l’acheteur. | |
| customer.billingDetails.address | Adresse de l’acheteur. | |
| customer.billingDetails.zipCode | Code postal. | |
| customer.billingDetails.city | Ville. |
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"
}