Créer un jeton mobile à usage unique
POST /customervault/v1/singleusetokens
L’API Coffre-fort client vous permet de créer des jetons à usage unique, qui sont ensuite utilisés avec un appareil mobile pour traiter un achat par l’intermédiaire de l’API Paiements par carte.
Vous pouvez également utiliser les jetons à usage unique pour d’autres demandes dans l’API Coffre-fort client, comme la création de profils et de jetons de paiement permanents.
Vous devez générer un nouveau jeton à usage unique pour chaque transaction API Paiements par carte ou Coffre-fort client que vous souhaitez traiter. Les jetons à usage unique ne sont valides que pendant 15 minutes et ne sont pas consommés lorsqu’ils sont utilisés pour une requête de vérification.
L’exemple ci-dessous montre comment créer un jeton à usage unique. Dans la réponse, vous trouverez une valeur 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
curl -X POST https://api.test.paysafe.com/customervault/v1/singleusetokens \
-u OT1625:B-qa2-0-53625f86-302c021476f52bdc9deab7aea876bb28762e62f92fc6712d0214736abf501e9675e55940e83ef77f5c304edc7968 \
-H 'Content-Type: application/json' \
-d '{
"card": {
"holderName": "MR. JOHN SMITH",
"cardNum": "4111111111111111",
"cardExpiry": {
"month": 12,
"year": 2019
},
"billingAddress": {
"street": "100 Queen Street West",
"street2": "Unit 201",
"city": "Toronto",
"country": "CA",
"state": "ON",
"zip": "M5H 2N2"
}
}
}'
| Valeur | Requis? | Type | Description |
|---|---|---|---|
| carte | Oui | object | Les données de la carte, y compris la date d’expiration de la carte et l’adresse de facturation. |
{
"id": "a02e52c7-c991-4418-966a-b62989cb0eae",
"paymentToken": "abcdefg23d32d2",
"timeToLiveSeconds": 899,
"card": {
"cardBin": "411111",
"lastDigits": "1111",
"holderName": "MR. JOHN SMITH",
"cardType": "VI",
"cardExpiry": {
"month": 12,
"year": 2019
}
},
"billingAddress": {
"street": "100 Queen Street West",
"street2": "Unit 201",
"city": "Toronto",
"country": "CA",
"state": "ON",
"zip": "M5H 2N2"
}
}
La réponse contient le paymentToken et une valeur timeToLiveSeconds qui indique le nombre de secondes restantes pour ce jeton de paiement. Les jetons à usage unique durent 15 minutes.
| Valeur | Type | Description |
|---|---|---|
| billingAddress | object | Il s’agit de l’adresse de facturation de la carte. |
| carte | object | Il s’agit de la carte que Paysafe enverra au réseau de paiement. |
| 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. |