Utilisation de cURL
cURL est un outil de ligne de commande qui peut être utilisé pour envoyer des requêtes à une API REST.
cURL peut être utilisé pour envoyer une requête HTTPS à Paysafe qui contient une méthode (POST pour une demande de paiement et GET pour récupérer des données), des en-têtes de requête (avec les détails de l’authentification) et un corps de requête (avec les détails de la requête API au format JSON). Paysafe répond avec un code d’état (p. ex. 200 OK), des en-têtes de réponse et un corps de réponse.
Vous trouverez ci-dessous un exemple de requête cURL pour l’API Paysafe :
curl -X POST https://api.test.paysafe.com/cardpayments/v1/accounts/89987201/auths \
-u devcentre322:B-qa2-0-53625f86-302c021476f52bdc9deab7aea876bb28762e62f92fc6712d0214736abf501e9675e55940e83ef77f5c304edc7968 \
-H 'Content-Type: application/json' \
-d ' {
"merchantRefNum": "demo-1",
"amount": 10098,
"settleWithAuth": true,
"card": {
"cardNum": "4111111111111111",
"cardExpiry": {
"month": 2,
"year": 2027
},
"cvv": 123
},
"billingDetails": {
"street": "100 Queen Street West",
"city": "Toronto",
"state": "ON",
"country": "CA",
"zip": "M5H 2N2"
}
} '
Le tableau ci-dessous détaille les paramètres qui peuvent être définis dans la requête cURL.
| Paramètre | Description | Exemple |
|---|---|---|
| curl | La requête cURL inclut l’URL ou le point de terminaison d’API auquel vous vous connectez en tant que paramètre final. Sur la plateforme de paiement Paysafe, le point de terminaison d’API dépend du type de requête. | curl -x POST https://api.test.paysafe.com/cardpayments/v1/accounts/89987201/auths |
| -x POST | Il s’agit de la méthode HTTP à utiliser. Les API Paysafe utilisent GET, POST, PUT et DELETE | -x POST |
| -H | Spécifier un en-tête HTTP et son contenu. Ceci est généralement utilisé pour définir l’en-tête Content-Type, qui est toujours application/json ou application/json; charset=utf-8"merchantRefNum": "demo-1", "amount": 10098, "settleWithAuth": true, "card": { "cardNum": "4111111111111111", "cardExpiry": { "month": 2, "year": 2017 }, "cvv": 123 }, "billingDetails": { "street": "100 Queen Street West", "city": "Toronto", "state": "ON", "country": "CA", "zip": "M5H 2N2" } ’ |
-
Nous vous recommandons d’utiliser Python json.tool pour formater la réponse JSON. A partir d’une ligne de commande Unix, cela peut être réalisé comme suit :
curl -X GET https://api.test.paysafe.com/cardpayments/monitor | python -mjson.tool
- Dans les exemples de ce guide, le symbole de barre oblique \ est inclus pour indiquer à cURL d’ignorer le formatage des sauts de ligne. Notez que \ est reconnue uniquement par les clients Unix ou MAC en ligne de commande et n’est pas pris en charge pour les clients Windows. Pour utiliser cURL à partir de la ligne de commande Windows, voir : https://developer.zendesk.com/documentation/api-basics/getting-started/installing-and-using-curl/
- Nous recommandons de placer les requêtes dans des fichiers en utilisant @. Si vous commencez les données par le caractère @, le reste doit être un nom de fichier à partir duquel les données sont lues. L’affichage des données d’un fichier nommé « foobar » se ferait donc avec -d @foobar.