Initier une demande de paiement depuis un bouton natif
L’application du marchand reçoit un objet token d’Apple Pay. Cet objet contient la payload de paiement envoyée par Apple.
L’application initie une demande de paiement avec cette payload via un appel au Web Service Charge/CreatePayment.
En réponse, la plateforme de paiement renvoie un formToken, un objet encrypté 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 |
|---|---|---|
| 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 |
| payload.type | Permet d’identifier le wallet Valorisé à APPLE_PAY | Oui |
| payload.data.token.paymentData | Contient les données de l’objet token envoyées
par Apple. Ex : (appleToken.paymentData) | Oui |
| payload.data.token.paymentMethod.displayName | Contient les données de la carte envoyées par
Apple. Ex : (appleToken.paymentMethod.displayName) | Oui |
| payload.data.token.paymentMethod.network | Contient les données du réseau de la carte
envoyées par Apple. Ex : (appleToken.paymentMethod.network) | Oui |
| payload.data.token.paymentMethod.type | Contient les données du type de carte envoyées
par Apple. Ex : (appleToken.paymentMethod.type) | Oui |
| payload.data.token.transactionIdentifier | Contient l’ID de la transaction envoyée par
Apple. Ex : (appleToken.transactionIdentifier) | Oui |
| ipnTargetUrl | Permet de surcharger l’URL de notification instantanée (également appelée IPN) dans le formulaire. | Non |
| customer.email | Adresse e-mail qui sera utilisée pour l’envoi du ticket de paiement à l’acheteur. | Non |
| transactionOptions.cardOptions.captureDelay | Délai de remise. | 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 |
| customer.shippingDetails | Objet contenant le détail de l'adresse de
livraison. Cet objet et ses attributs sont recommandés. | Non |
| customer.shoppingCart | Objet contenant le détail du panier. Cet objet et ses attributs sont recommandés. | Non |
| transactionOptions.cardOptions.manualValidation | Mode de validation du paiement. | 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": 999,
"currency": "EUR",
"orderId": "myOrderId-930275",
"payload": {
"type": "APPLE_PAY",
"data": {
"token": {
"paymentData":"(appleToken.paymentData)",
"paymentMethod": {
"displayName": "(appleToken.paymentMethod.displayName)",
"network": "(appleToken.paymentMethod.network)",
"type": "(appleToken.paymentMethod.type)"
}
"transactionIdentifier": "(appleToken.transactionIdentifier)"
}
}
}