Point de terminaison d’API
Le point de terminaison d’API (URI ou URL) doit pointer vers l’environnement de test ou de production (en direct).
- Point de terminaison d’API de test : https://api.test.paysafe.com/
Par exemple : https://api.test.paysafe.com/directdebit/monitor - Point de terminaison d’API de production : https://api.paysafe.com/
Par exemple : https://api.paysafe.com/directdebit/monitor
Modèles de point de terminaison d’API
Les points de terminaison d’API se conforment généralement au modèle de l’exemple ci-dessous :
https://api.test.paysafe.com/directdebit/v1/accounts/account_id/APIrequest
Remplacez les éléments de l’exemple de point de terminaison d’API ci-dessus par ce qui suit :
Élément | Usage |
---|---|
test | Utilisez test pour une transaction de test. Retirez le mot « test » pour une transaction réelle. |
directdebit | Remplacez par l’API que vous utilisez. Les valeurs éventuelles sont les suivantes :
|
account_id | Remplacez par votre numéro de compte marchand unique. Les marchands peuvent avoir plusieurs comptes, par exemple pour traiter des paiements dans différentes devises. Tous les comptes peuvent être configurés pour être utilisés avec la même clé API. |
APIrequest | Remplacez par le type de requête API, comme les achats et les crédits. |
v1 | Il s’agit de la version de l’API. Actuellement, toutes les API sont en version 1. |
Le tableau ci-dessous donne d’autres exemples.
Requête API | Utilisation | Modèle de point de terminaison |
---|---|---|
Achats | Traiter une requête d’achat par prélèvement automatique | POST/directdebit/v1/accounts/account_id/purchases |
Annuler des achats | Annuler une requête d’achat par prélèvement automatique. | PUT/directdebit/v1/accounts/account_id/purchases/purchase_id |
Obtenir des achats | Rechercher une requête d’achat par prélèvement automatique en utilisant l’identifiant renvoyé dans la réponse à la requête initiale. | GET/directdebit/v1/accounts/account_id/purchases/purchase_id |
Crédits autonomes | Créditer un montant sur le compte bancaire d’un client. | POST/directdebit/v1/accounts/account_id/standalonecredits |
- Dans les exemples ci-dessus, remplacez account_id par votre numéro de compte marchand unique et remplacez id par l’identifiant unique de la transaction initiale.
- Certains points de terminaison d’API comportent plusieurs paramètres. Par exemple, dans le cas d’une requête de recherche d’achat, account_id et purchase_id doivent être inclus.
- Les exemples renvoient au système de production.
Points d’extrémité d’API hérités
Nous recommandons aux clients qui utilisent les points d’extrémité d’API suivants de migrer vers les points de terminaison d’API Paysafe ci-dessus :
- Test : https://api.test.netbanx.com
- Production : https://api.netbanx.com