Rechercher une transaction d’autorisation
GET /cardpayments/v1/accounts/account_id/auths/transaction_id
Voir notre rubrique Référence API pour une liste de tous les attributs et types JSON disponibles pour l’objet authorization renvoyé dans la réponse. Notez que certains paramètres ne sont utilisés que lors de la requête d’autorisation. Voir les liens suivants pour plus de détails sur la recherche d’autorisations et tous les paramètres de requête et de réponse possibles :
Vous pouvez consulter une transaction d’autorisation existante en indiquant votre numéro de compte et l’identifiant de la transaction (renvoyé dans la réponse d’autorisation) dans l’URL comme suit :
curl -X GET https://api.test.paysafe.com/cardpayments/v1/accounts/89987201/auths/ebf6ae3d-88e1-40da-9b98-81044467345b \
-u devcentre322:B-qa2-0-53625f86-302c021476f52bdc9deab7aea876bb28762e62f92fc6712d0214736abf501e9675e55940e83ef77f5c304edc7968 \
-H 'Content-Type: application/json'
Avant d’essayer l’exemple, vous devez :
- Remplacer le numéro de compte (89987201) dans l’URL par le numéro de compte de test que vous avez reçu.
- Remplacer la clé API (après le -u) par la clé API que vous avez reçue.
- Remplacez l’identifiant de transaction dans l’URL par un identifiant de transaction renvoyé dans une réponse antérieure à une requête d’autorisation que vous avez soumise.
Si vous n’avez pas d’identifiant de transaction, vous pouvez rechercher une transaction en fonction de l’élément merchantRefNum que vous avez fourni avec la requête initiale :
GET /cardpayments/v1/accounts/account_id/auths?merchantRefNum=merchantRefNum
curl -X GET https://api.test.paysafe.com/cardpayments/v1/accounts/89987201/auths?merchantRefNum=demo-1 \
-u devcentre322:B-qa2-0-53625f86-302c021476f52bdc9deab7aea876bb28762e62f92fc6712d0214736abf501e9675e55940e83ef77f5c304edc7968 \
-H 'Content-Type: application/json'
Avant d’essayer l’exemple, vous devez :
- Remplacer le numéro de compte (89987201) dans l’URL par le numéro de compte de test que vous avez reçu.
- Remplacer la clé API (après le -u) par la clé API que vous avez reçue.
{
"links":[
{
"rel":"self",
"href":"https://api.test.paysafe.com/cardpayments/v1/accounts/89987201/auths/ebf6ae3d-88e1-40da-9b98-81044467345b"
}
],
"id":"ebf6ae3d-88e1-40da-9b98-81044467345b",
"merchantRefNum":"demo-1",
"txnTime":"2014-05-05T12:28:20Z",
"status":"COMPLETED",
"amount":10098,
"availableToSettle":10098,
"card":{
"type":"VI",
"lastDigits":"1111",
"cardExpiry":{
"month":2,
"year":2027
}
},
"authCode":"118428",
"billingDetails":{
"street":"100 Queen Street West",
"city":"Toronto",
"state":"ON",
"country":"CA",
"zip":"M5H2N2"
},
"merchantDescriptor":{
"dynamicDescriptor":"Test",
"phone":"123-1234123"
},
"currencyCode":"CAD",
"avsResponse":"MATCH"
}
La réponse comporte les paramètres suivants :
| Élément | Élément enfant | Type | Description |
|---|---|---|---|
| links | tableau d’objets de lien | Ce paramètre contient un lien « self » unique qui peut être utilisé pour obtenir des détails sur cette autorisation. | |
| Id | string length<=36 | Il s’agit de l’identifiant unique de cette autorisation. | |
| merchantRefNum | string length<=255 | Il s’agit du numéro de référence du marchand. | |
| txnTime | string | Il s’agit de l’heure et de la date de la transaction au format TUC. | |
| status | enum | Il s’agit de l’état de l’autorisation. Les valeurs éventuelles sont :
| |
| montant | integer max=99999999999 | Il s’agit du montant en unités mineures demandé pour cette autorisation. | |
| availableToSettle | integer max=99999999999 | Il s’agit du montant disponible pour le règlement, en unités mineures. Si cette valeur est égale à 0, l’autorisation a été entièrement réglée (saisie). | |
| carte | lastDigits | string length=4 | Il s’agit des quatre derniers chiffres de la carte utilisée pour la requête. |
| type | enum | Il s’agit du numéro de carte utilisé pour la requête. Les valeurs éventuelles sont :
| |
| authCode | string length<=50 | Il s’agit du code d’autorisation renvoyé par la banque émettrice. | |
| billingDetails | street | string length<=50 | Il s’agit de la première ligne de l’adresse municipale figurant dans l’adresse de facturation. |
| city | string length<=40 | Il s’agit de la ville figurant dans l’adresse de facturation. | |
| state | string length<=40 | Il s’agit de la province ou de l’État ou de la province figurant dans l’adresse de facturation. | |
| country | string length=2 | Il s’agit du pays figurant dans l’adresse de facturation. | |
| zip | string length<=10 | Il s’agit du code postal de l’adresse de facturation. | |
| merchantDescriptor | dynamicDescriptor | string | Il s’agit d’un descripteur de marchand qui sera affiché sur le relevé de carte du client. Vous pouvez soit envoyer cette information dans la requête, soit demander à Paysafe Group de configurer une valeur par défaut pour ce paramètre pour votre compte. |
| phone | string | Il s’agit du numéro de téléphone du marchand, qui sera ajouté au descripteur du marchand sur le relevé de carte du client. | |
| currencyCode | string | Il s’agit du code de devise à trois chiffres du compte marchand spécifié dans le paramètre URL de la requête account_id lors de la création de cette autorisation. | |
| avsResponse | enum | Il s’agit de la réponse du service de vérification d’adresse (SVA) de l’émetteur de la carte :
L’adresse dans l’objet billingDetails de la requête est vérifiée par rapport à l’adresse que l’émetteur a dans ses dossiers pour la carte. |