Initialiser une demande de paiement via Apple Pay
Le site marchand initie une demande de paiement via un appel au Web Service Charge/CreatePayment.
En réponse, le serveur marchand récupère un formToken, un objet encrypté permettant d’initialiser le formulaire intelligent (smartForm) avec les informations de la transaction et celles correspondant à la configuration de boutique.
Prérequis si vous étiez déjà un utilisateur du formulaire embarqué
- En mode embarqué, utilisez la class kr-smart-form à la place de la
classe
kr-embedded.Exemple
<body> <!-- new class kr-smart-form to replace the class kr-embedded --> <div class="kr-smart-form" kr-form-token="[GENERATED FORMTOKEN]"> (...) </div> </body>
- En mode pop-in, utilisez la class kr-smart-form avec le paramètre
kr-popin.Exemple
<body> <!-- new class kr-smart-form with a kr-popin --> <div class="kr-smart-form" kr-popin kr-form-token="[GENERATED FORMTOKEN]"> (...) </div> </body>
Internet Explorer 11 est obsolète selon Microsoft depuis juin 2022.
L'intégration du formulaire intelligent (smartForm) n'est pas supportée par ce navigateur.
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. Attention : à ce jour, le formulaire
intelligent (smartForm) n'est pas encore compatible avec
l’ajout de carte dans un wallet via la valeur
CUSTOMER_WALLET. | 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. Ce champ est recommandé. | Non |
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. Ce champ est recommandé. | Non |
customer.reference | Identifiant de l’acheteur sur le site
marchand. Ce champ est recommandé. | Non |
customer.billingDetails | Objet contenant le détail de l'adresse de
facturation. Cet objet et ses attributs sont recommandés. | 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 |
transactionOptions.cardOptions.captureDelay | Délai de remise. | 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.lyra.com/api-payment/V4/Charge/CreatePayment
{ "amount": "100", "currency": "EUR", "orderId": "demo-6336a0db503c6", "customer": { "reference": "My-Reference", "email": "main@example.com", "billingDetails": { "title": "M.", "category": "PRIVATE", "firstName": "ALFRED", "lastName": "DUBOIS", "phoneNumber": "0673567800", "streetNumber": "3", "address": "rue du Gorp", "district": "Saint-Michel", "zipCode": "31000", "city": "Toulouse" }, "shippingDetails": { "address": "rue du Gorp", "address2": "110 Appart B", "city": "Toulouse", "country": "FR", "deliveryCompanyName": "DeliveryCompany", "district": "Saint-Michel", "firstName": "ALFRED", "lastName": "DUBOIS", "legalName": "My legal name ship", "shippingSpeed": "EXPRESS", "shippingMethod": "ETICKET", "state": "Ok", "streetNumber": "3", "category": "COMPANY", "zipCode": "31000" } }, "formTokenVersion": 4 }
{ "shopId": "91335531", "orderCycle": "CLOSED", "orderStatus": "RUNNING", "serverDate": "2022-10-21T15:30:18+00:00", "orderDetails": { "orderTotalAmount": 100, "orderEffectiveAmount": 100, "orderCurrency": "EUR", "mode": "PRODUCTION", "orderId": "demo-6352bae7585b3", "metadata": null, "_type": "V4\/OrderDetails" }, "customer": { "billingDetails": { "address": "rue du Gorp", "category": "PRIVATE", "cellPhoneNumber": null, "city": "Toulouse", "country": null, "district": "Saint-Michel", "firstName": "ALFRED", "identityCode": null, "identityType": null, "language": "FR", "lastName": "DUBOIS", "phoneNumber": "0673567800", "state": null, "streetNumber": "3", "title": "M.", "zipCode": "31000", "legalName": null, "_type": "V4/Customer/BillingDetails" }, "extraDetails": { "browserAccept": null, "fingerPrintId": null, "ipAddress": "185.244.73.2", "browserUserAgent": "Mozilla\/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit\/605.1.15 (KHTML, like Gecko) Version\/16.0 Safari\/605.1.15", "_type": "V4\/Customer\/ExtraDetails" }, "transactions": [ { "shopId": "91335531", "uuid": "6a0688428ec3490591abce6e1e08d8fe", "amount": 100, "currency": "EUR", "paymentMethodType": "CARD", "status": "RUNNING", "detailedStatus": "AUTHORISED_TO_VALIDATE", "operationType": "DEBIT", "effectiveStrongAuthentication": "DISABLED", "creationDate": "2022-10-21T15:30:15+00:00", "transactionDetails": { "liabilityShift": "YES", "effectiveAmount": 100, "effectiveCurrency": "EUR", "creationContext": "CHARGE", "cardDetails": { "paymentSource": "EC", "manualValidation": "YES", "expectedCaptureDate": "2022-10-21T15:30:15+00:00", "effectiveBrand": "VISA", "pan": "XXXXXXXXXXXX4187", "expiryMonth": 12, "expiryYear": 2023, "country": "FR", "effectiveProductCode": "F", "legacyTransId": "934329", "legacyTransDate": "2022-10-21T15:30:15+00:00", "paymentMethodSource": "NEW", "authorizationResponse": { "amount": 100, "currency": "EUR", "authorizationDate": "2022-10-21T15:30:15+00:00", "authorizationNumber": "510231", "authorizationResult": "0", "authorizationMode": "FULL", "_type": "V4\/PaymentMethod\/Details\/Cards\/CardAuthorizationResponse" },