Rechercher une transaction d’achat
Vous pouvez rechercher une transaction d’achat existante en effectuant une requête GET au point de terminaison contenant le numéro de compte et l’identifiant de transaction dans l’URL.
GET /directdebit/v1/accounts/account_id/purchases/purchase_id
curl -X GET https://api.test.paysafe.com/directdebit/v1/accounts/89987201/purchases/a02e52c7-c991-4418-966a-b62989cb0eae \
-u devcentre322:B-qa2-0-53625f86-302c021476f52bdc9deab7aea876bb28762e62f92fc6712d0214736abf501e9675e55940e83ef77f5c304edc7968 \
-H 'Content-Type: application/json'
Avant d’essayer l’exemple, vous devez :
- Remplacez account_id (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 purchase_id (a02e52c7-c991-4418-966a-b62989cb0eae) dans l’URL par votre identifiant d’achat renvoyé dans la réponse à la requête d’achat initiale.
Vous pouvez rechercher des transactions à l’aide d’un identifiant de transaction jusqu’à un maximum d’un an dans le passé.
{
"links": [
{
"rel": "self",
"href": "https://api.test.paysafe.com/directdebit/v1/accounts/89987201/purchases/a02e52c7-c991-4418-966a-b62989cb0eae"
}
],
"id": "a02e52c7-c991-4418-966a-b62989cb0eae",
"txnTime": "2016-12-14T15:12:18Z",
"status": "PENDING",
"merchantRefNum": "123456789",
"amount": 2599,
"customerIp": "192.0.126.111",
"dupCheck": true,
"ach": {
"accountHolderName": "First Company",
"accountType": "CHECKING",
"payMethod": "WEB",
"routingNumber": "211589828",
"paymentDescriptor": "Transaction",
"lastDigits": "09"
},
"profile": {
"firstName": "John",
"lastName": "Johnson",
"email": "john.johnson@emailserver.com",
"ssn": "123456789",
"dateOfBirth": {
"day": 24,
"month": 10,
"year": 1981
}
},
"billingDetails": {
"street": "100 Queen Street West",
"street2": "Apt. 55",
"city": "Ottawa",
"state": "ON",
"country": "CA",
"zip": "M1M 1M1",
"phone": "6139991100"
}
}
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 :
curl -X GET https://api.test.paysafe.com/directdebit/v1/accounts/89987201/purchases?merchantRefNum=merchant-ABC-123&limit=2 \
-u devcentre322:B-qa2-0-53625f86-302c021476f52bdc9deab7aea876bb28762e62f92fc6712d0214736abf501e9675e55940e83ef77f5c304edc7968 \
-H 'Content-Type: application/json'
Le paramètre de chaîne de requête ajouté au point de terminaison d’API pour une recherche utilisant un numéro de référence du marchand doit avoir le format indiqué dans l’exemple suivant :
GET /directdebit/v1/accounts/account_id/purchases?merchantRefNum=merchant_ref_number
Si la valeur merchantRefNum que vous utilisez n’est pas unique (c’est-à-dire que vous avez désactivé la vérification des transactions en double et que vous utilisez le même numéro de référence du marchand pour plusieurs transactions), la réponse à la consultation contiendra les 10 derniers enregistrements liés au merchantRefNum. Vous pouvez spécifier le nombre exact d’enregistrements à extraire en ajoutant le paramètre limit à la fin du point de terminaison d’API, par exemple :
/directdebit/v1/accounts/account_id/purchases?merchantRefNum=merchant_ref_number&limit=N,
où N = le nombre d’enregistrements à renvoyer (la valeur maximale est de 50).
{
"links": [
{
"rel": "self",
"href": "https://api.test.paysafe.com/directdebit/v1/accounts/1001058140/purchases?merchantRefNum=merchant-ABC-123&limit=2"
},
{
"rel": "next",
"href": "https://api.test.paysafe.com/directdebit/v1/accounts/1001058140/purchases?merchantRefNum=merchant-ABC-123&limit=2&offset=4&startDate=2016-07-13T19:15:45Z&endDate=2016-08-12T19:15:45Z"
},
{
"rel": "previous",
"href": "https://api.test.paysafe.com/directdebit/v1/accounts/1001058140/purchases?merchantRefNum=merchant-ABC-123&limit=2&offset=0&startDate=2016-07-13T19:15:45Z&endDate=2016-08-12T19:15:45Z"
}
],
"purchases": [
{
"id": "a02e52c7-c991-4418-966a-b62989cb0eae",
"txnTime": "2016-12-14T15:12:18Z",
"status": "PENDING",
"merchantRefNum": "merchant",
"amount": 2599,
"customerIp": "192.0.126.111",
"ach": {
"accountHolderName": "First Company",
"accountType": "CHECKING",
"payMethod": "WEB",
"routingNumber": "211589828",
"paymentDescriptor": "Transaction",
"lastDigits": "09"
},
"profile": {
"firstName": "John",
"lastName": "Johnson",
"email": "john.johnson@emailserver.com",
"ssn": "123456789",
"dateOfBirth": {
"day": 24,
"month": 10,
"year": 1981
}
},
"billingDetails": {
"street": "100 Queen Street West",
"street2": "Apt. 55",
"city": "Ottawa",
"state": "ON",
"country": "Canada",
"zip": "M1M 1M1",
"phone": "6139991100"
},
"links": {
"rel": "self",
"href": "https://api.test.paysafe.com/directdebit/v1/accounts/1001058140/purchases/a02e52c7-c991-4418-966a-b62989cb0eae"
}
},
{
"id": "4c99e967-517e-4610-b3bf-364d6b3492a1",
"txnTime": "2016-12-14T15:12:18Z",
"status": "PENDING",
"merchantRefNum": "merchant",
"amount": 2599,
"customerIp": "192.0.126.111",
"ach": {
"accountHolderName": "First Company",
"accountType": "CHECKING",
"payMethod": "WEB",
"routingNumber": "211589828",
"paymentDescriptor": "Transaction",
"lastDigits": "09"
},
"profile": {
"firstName": "John",
"lastName": "Johnson",
"email": "john.johnson@emailserver.com",
"ssn": "123456789",
"dateOfBirth": {
"day": 24,
"month": 10,
"year": 1981
}
},
"billingDetails": {
"street": "100 Queen Street West",
"street2": "Apt. 55",
"city": "Ottawa",
"state": "ON",
"country": "Canada",
"zip": "M1M 1M1",
"phone": "6139991100"
},
"links": {
"rel": "self",
"href": "https://api.test.paysafe.com/directdebit/v1/accounts/1001058140/purchases/4c99e967-517e-4610-b3bf-364d6b3492a1"
}
}
]
}
Pour plus d’informations, y compris sur l’annulation d’un achat et le traitement d’un crédit autonome, consultez notre rubrique Référence API.