Créer un jeton à usage unique Apple Pay
POST /customervault/v1/applepaysingleusetokens
L’API Coffre-fort client vous permet de créer des jetons à usage unique, qui sont ensuite utilisés avec un appareil Apple pour traiter un achat par l’intermédiaire de l’API Paiements par carte. Les jetons à usage unique ne sont valides que 15 minutes et ne sont pas consommés par la vérification.
Vous devez générer un nouveau jeton à usage unique pour chaque transaction par API Paiements par carte que vous voulez traiter.
L’exemple ci-dessous montre comment créer un jeton Apple Pay à usage unique. Dans la réponse, vous trouverez un paymentToken que vous joindrez à votre requête d’autorisation ou d’achat.
Avant d’essayer l’exemple ci-dessus, vous devez :
- Remplacez la clé API (après le u) par votre clé API pour jetons à usage unique
- Remplacez la valeur de l’élément data par les données de paiement chiffrées PassKit valides.
- Remplacez la valeur de l’élément signature par une signature de paiement et des données d’en-tête valides.
- Remplacez les valeurs des sous-éléments header par les valeurs valides de l’appareil iOS.
curl -X POST https://api.test.paysafe.com/customervault/v1/applepaysingleusetokens \
-u OT1625:B-qa2-0-53625f86-302c021476f52bdc9deab7aea876bb28762e62f92fc6712d0214736abf501e9675e55940e83ef77f5c304edc7968 \
-H ’Content-Type: application/json’ \
-d ’ {
"applePayPaymentToken": {
"version": "EC_v1",
"data": "<passkit_encrypted_payment_data>",
"signature": "<signature_for_payment_and_header_data>",
"header": {
"transactionId": "b53e22ef6669ce7f50951cfd6821908f4e679f050f5a551a1b5f6202253136ae",
"ephemeralPublicKey": "MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEB39YqvWZG0NOYjbkL5D61Mxip6uw23Q7m8gWgxL41k4fs0BgJ+MFcIGYOH86kAGL/wjiftDahRkUnzOGls2hzw==",
"publicKeyHash": "O5gJ/P5sQ7ufMZQXA7ccLoOkJ13VNknbu+4K0TaCQXE="
}
}
}’
| Valeur | Requis? | Type | Description |
|---|---|---|---|
| applePayPaymentToken | Oui | object | L’objet de données de paiement généré à partir de l’appareil iOS pour Apple Pay. |
{
"id": "a02e52c7-c991-4418-966a-b62989cb0eae",
"paymentToken" : "ABC4AFQQBC5UR5H",
"timeToLiveSeconds" : "899",
"applePayPaymentToken": {
"version": "EC_v1",
"signature": "<signature_for_payment_and_header_data>",
"header": {
"transactionId": "b53e22ef6669ce7f50951cfd6821908f4e679f050f5a551a1b5f6202253136ae",
"publicKeyHash": "O5gJ/P5sQ7ufMZQXA7ccLoOkJ13VNknbu+4K0TaCQXE="
}
},
"card": {
"lastDigits": "1111",
"holderName": "Joe Smith"
},
"transaction": {
"amount": 1000,
"currencyCode": "USD"
}
}
| Valeur | Type | Description |
|---|---|---|
| applePayPaymentToken | object | Il s’agit de l’objet de données de paiement généré à partir de l’appareil iOS pour Apple Pay. |
| carte | object | Il s’agit des détails de la carte virtuelle. |
| Id | string | Il s’agit de l’identifiant de la requête. |
| paymentToken | string | Il s’agit du jeton de paiement à usage unique qui sera utilisé pour la requête d’autorisation/d’achat. |
| timeToLiveSeconds | integer | C’est la période pendant laquelle le jeton à usage unique est valide avant expiration, en secondes, renvoyé dans la réponse. |
| transaction | object | Il s’agit des détails de la transaction Apple Pay. |
Voire notre rubrique Référence API complète pour une description intégrale.