Transaction avec un Payment Handle
Une fois que vous avez reçu le "payment handle" à usage unique, vous pouvez l’utiliser pour effectuer un paiement à l’aide de l’API Paiements.
Si vos transactions sont libellées en plusieurs devises, vous devez réfléchir à la manière dont vous allez gérer les multiples comptes marchands concernés et sélectionner le bon compte à utiliser lors de l’encaissement des paiements.
Le gestionnaire à usage unique est en fait appelée jeton lorsqu’il est créé par les SDK et paymentToken lorsqu’il est créé par l’API Paiements. Aussi appelé paymentToken lorsqu’il est utilisé avec l’API Paiements dans le cadre d’un paiement; Crédit initial; Crédit autonome; Vérifications;
Le point de terminaison de paiement utilise la clé API de serveur à serveur. N’utilisez pas l’API Paiements à partir du navigateur Web du client, car cela exposerait cette clé.
Paiement
Appelez le point de terminaison suivant à partir de votre serveur pour accepter le paiement : POST
POST /paymenthub/v1/payments
Exemple de requête de paiement
curl -X POST https://api.test.paysafe.com/paymenthub/v1/payments \
-u devcentre322:B-qa2-0-53625f86-302c021476f52bdc9deab7aea876bb28762e62f92fc6712d0214736abf501e9675e55940e83ef77f5c304edc7968 \
-H ’Content-Type: application/json’ \
-d ’ {
"merchantRefNum": "10f64573-65d8-4d14-8337-66264094662f",
"amount":1407,"amount": 1407,
"currencyCode": "USD",
"dupCheck": false,
"settleWithAuth": true,
"paymentHandleToken": "SC7nzOK9blfEKX1r",
"description": "Demo Paysafe Js"
} ’
Avant d’essayer l’exemple, vous devez :
- Remplacez le nom d’utilisateur et le mot de passe de la clé API (après le -u) par la clé API Test que vous avez reçu de Paysafe.
- Substituez le paymentToken par le jeton de la carte de test que vous avez obtenu de Paysafe.js.
Si le système de vérification des adresses (AVS) est activé sur votre compte, vous devez inclure une adresse de facturation dans l’appel d’autorisation à l’aide de l’objet billingDetails. L’adresse de facturation est l’adresse de la carte représentée par le jeton de paiement. Notez que les comptes de test du Centre des développeurs ont activé AVS.
Exemple de réponse à un paiement
{
"id": "3f7992f8-f550-42a7-bc10-79728a43d3c6",
"paymentType": "CARD",
"paymentHandleToken": "SC7nzOK9blfEKX1r",
"merchantRefNum": "10f64573-65d8-4d14-8337-66264094662f",
"currencyCode": "USD",
"settleWithAuth": false,
"txnTime": "2022-01-14T13:17:03Z",
"billingDetails": {
"street": "Oak Fields 6",
"city": "ca",
"zip": "90210",
"state": "CA",
"country": "US"
},
"status": "COMPLETED",
"amount":1407,"amount": 1407,
"preAuth": false,
"description": "Demo Paysafe Js",
"availableToSettle": 1407,
"gatewayResponse": {
"code": "CRX",
"responseCode": "0",
"responseId": "713965",
"requestId": "4397082830",
"description": "Transaction has been executed successfully.",
"authCode": "682110",
"txnDateTime": "01/14/2022 at 08:17:03 EST",
"referenceNbr": "1420817031393",
"responseReasonCode": "00",
"cvv2Result": "S",
"avsResponse": "UNKNOWN",
"cvvVerification": "NOT_PROCESSED",
"serializable": true
},
"profile": {
"locale": "en",
"firstName":"John",
"lastName" : "Smith",
"email": "john@smith.com"
},
"card": {
"cardExpiry": {
"month": "3",
"year": "2025"
},
"cardType": "VI",
"cardBin": "411111",
"lastDigits": "1111",
"cardCategory": "CREDIT"
}
}
Si la carte spécifiée ou identifiée par un gestionnaire dans la requête est inscrite à 3DS, la réponse contiendra un objet d’authentification contenant les détails de l’inscription.
Vérifications
Voir Vérification
Appelez le point de terminaison suivant à partir de votre serveur pour accepter le paiement : POST
POST /paymenthub/v1/verifications
Exemple de requête de vérifications
curl -X POST https://api.test.paysafe.com/paymenthub/v1/verifications \
-u devcentre322:B-qa2-0-53625f86-302c021476f52bdc9deab7aea876bb28762e62f92fc6712d0214736abf501e9675e55940e83ef77f5c304edc7968 \
-H ’Content-Type: application/json’ \
-d ’ {
"merchantRefNum": "10f64573-65d8-4d14-8337-66264094662f",
"amount":1407,"amount": 1407,
"currencyCode": "USD",
"paymentHandleToken": "SC7nzOK9blfEKX1r",
"description": "Demo Paysafe Js"
} ’
Avant d’essayer l’exemple, vous devez :
- Remplacez le nom d’utilisateur et le mot de passe de la clé API (après le -u) par la clé API Test que vous avez reçue de Paysafe.
- Substituez le paymentToken par le jeton de la carte de test que vous avez obtenu de Paysafe.js.
Si le système de vérification des adresses (AVS) est activé sur votre compte, vous devez inclure une adresse de facturation dans l’appel d’autorisation à l’aide de l’objet billingDetails. L’adresse de facturation est l’adresse de la carte représentée par le jeton de paiement. Notez que les comptes de test du Centre des développeurs ont activé AVS.
Exemple de réponse à des vérifications
{
"id": "dc04b025-796a-4538-a738-a2ff0b83a11e",
"paymentType": "MAZOOMA",
"merchantRefNum": "SriTest-1644827349",
"currencyCode": "USD",
"txnTime": "2022-02-14T08:29:27Z",
"billingDetails": {
"street1": "Queen Street West",
"street2": "Queen Street",
"city": "Imphal",
"zip": "14236",
"state": "NY",
"country": "US"
},
"status": "COMPLETED",
"amount": 100,
"updatedTime": "2022-02-14T08:29:28Z",
"statusTime": "2022-02-14T08:29:28Z",
"liveMode": false,
"simulator": "EXTERNAL",
"gatewayResponse": {
"processor": "MAZOOMA"
},
"mazooma": {
"consumerId": "PP_100222",
"achBankAccounts": [
{
"lastDigits": "11",
"bankName": "CHASE",
"paymentToken": "BAFtcP4i8r0udbEK"
}
]
},
"profile": {
"firstName": "ALBERTA",
"lastName": "BOBBETHCHARLESON",
"email": "accountholder0@example.com",
"dateOfBirth": {
"day": 23,
"month": 12,
"year": 1990
},
"phone": "1234567890"
}
}
Crédit autonome
Voir process-standalone-credit
Appelez le point de terminaison suivant à partir de votre serveur pour encaisser le paiement :
POST /paymenthub/v1/standalonecredits
curl -X POST https://api.test.paysafe.com/paymenthub/v1/standalonecredits \
-u devcentre322:B-qa2-0-53625f86-302c021476f52bdc9deab7aea876bb28762e62f92fc6712d0214736abf501e9675e55940e83ef77f5c304edc7968 \
-H ’Content-Type: application/json’ \
-d ’ {
"merchantRefNum": "10f64573-65d8-4d14-8337-66264094662f",
"amount":1407,"amount": 1407,
"currencyCode": "USD",
"paymentHandleToken": "SC7nzOK9blfEKX1r",
"description": "Demo Paysafe Js"
} ’
Avant d’essayer l’exemple, vous devez :
- Remplacez le nom d’utilisateur et le mot de passe de la clé API (après le -u) par la clé API Test que vous avez reçu de Paysafe.
- Substituez le paymentToken par le jeton de la carte de test que vous avez obtenu de Paysafe.js.
Si le système de vérification des adresses (AVS) est activé sur votre compte, vous devez inclure une adresse de facturation dans l’appel d’autorisation à l’aide de l’objet billingDetails. L’adresse de facturation est l’adresse de la carte représentée par le jeton de paiement. Notez que les comptes de test du Centre des développeurs ont activé AVS.
Exemple de réponse pour crédit autonome
{
"id": "e075f2ae-dfc4-4f6d-8d89-61158367b6a6",
"amount":1407,"amount": 1407,
"merchantRefNum": "10f64573-65d8-4d14-8337-66264094662f",
"paymentHandleToken": "SC7nzOK9blfEKX1r",
"customerIp": "204.91.0.12",
"currencyCode": "USD",
"paymentType": "CARD",
"status": "PENDING",
"description": "Demo Paysafe Js""
}
Crédit initial
Appelez le point de terminaison suivant à partir de votre serveur pour encaisser le paiement :
POST /paymenthub/v1/originalcredits
Exemple de requête pour crédit initial
curl -X POST https://api.test.paysafe.com/paymenthub/v1/originalcredits \
-u devcentre322:B-qa2-0-53625f86-302c021476f52bdc9deab7aea876bb28762e62f92fc6712d0214736abf501e9675e55940e83ef77f5c304edc7968 \
-H ’Content-Type: application/json’ \
-d ’ {
"merchantRefNum": "10f64573-65d8-4d14-8337-66264094662f",
"amount":1407,"amount": 1407,
"currencyCode": "USD",
"paymentHandleToken": "SC7nzOK9blfEKX1r",
"description": "Demo Paysafe Js"
} ’
Avant d’essayer l’exemple, vous devez :
- Remplacez le nom d’utilisateur et le mot de passe de la clé API (après le -u) par la clé API Test que vous avez reçu de Paysafe.
- Substituez le paymentToken par le jeton de la carte de test que vous avez obtenu de Paysafe.js.
Si le système de vérification des adresses (AVS) est activé sur votre compte, vous devez inclure une adresse de facturation dans l’appel d’autorisation à l’aide de l’objet billingDetails. L’adresse de facturation est l’adresse de la carte représentée par le jeton de paiement. Notez que les comptes de test du Centre des développeurs ont activé AVS.
Exemple de réponse pour crédit initial
{
"amount": 1407,
"merchantRefNum": "10f64573-65d8-4d14-8337-66264094662f",
"paymentHandleToken": "SC7nzOK9blfEKX1r",
"customerIp": "204.91.0.12",
"description": "Demo Paysafe Js"
}
Conversion d’un jeton à usage unique en jeton permanent
Vous pouvez convertir le jeton à usage unique en un jeton de paiement permanent réutilisable en l’utilisant pour créer un profil dans l’API de paiement —le champ paymentHandleTokenFrom renvoyé. Paysafe vous recommande de vérifier que le jeton à usage unique correspond à une carte valide avant de créer le profil.