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 temps réel).
- Point de terminaison d’API de test : https://api.test.paysafe.com/
Par exemple : https://api.test.paysafe.com/customervault/monitor - Point de terminaison d’API de production : https://api.paysafe.com/
Par exemple : https://api.paysafe.com/customervault/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/customervault/v1/profiles
Remplacez les éléments suivants dans l’exemple de point de terminaison d’API ci-dessus par les données suivantes :
| Élément | Usage |
|---|---|
test | Utilisez test pour une transaction de test. Retirez le mot test pour une transaction réelle. |
| customervault | À utiliser pour les requêtes de l’API Coffre-fort client. |
| v1 | Il s’agit de la version de l’API. Actuellement, toutes les API sont en version 1. |
| profiles | Utilisez l’élément profiles lorsque vous travaillez avec des profils de clients; remplacez les chemins d’accès du tableau ci-dessous pour d’autres utilisations. |
Le tableau ci-dessous donne d’autres exemples.
| API | Utilisé pour | Point de terminaison d’API |
|---|---|---|
| Créer un profil | Créer un nouveau profil client. | POST/customervault/v1/profiles |
| Créer une adresse | Créer et lier une adresse de client à un profil existant. Un profil peut avoir plusieurs adresses liées. | POST/customervault/v1/profiles/id/addresses |
| Créer une carte | Créer et lier une carte à un profil existant. Un profil peut avoir plusieurs cartes liées. | POST/customervault/v1/profiles/id/cards |
| Créer un compte bancaire | Créer et lier un compte bancaire (dans ce cas, un compte bancaire ACH) à un profil existant. Un profil peut avoir plusieurs comptes bancaires liés. | POST/customervault/v1/profiles/id/achbankaccounts |
| Créer un jeton à usage unique pour appareil mobile | Créer un jeton à usage unique pour les paiements par téléphone mobile. Les jetons à usage unique ne sont valides que 15 minutes et ne sont pas consommés par la vérification. | POST/customervault/v1/singleusetokens |
| Créer un jeton à usage unique ApplePay | Créer un jeton à usage unique pour les paiements par téléphone mobile avec ApplePay. Les jetons à usage unique ne sont valides que 15 minutes et ne sont pas consommés par la vérification. | POST/customervault/v1/applepaysingleusetokens |
| Autorisation avec un jeton de paiement | Le paiement est effectué à l’aide d’un jeton lié à un profil et à une carte. Notez que dans ce cas, l’API Paiements par carte est utilisée. | POST/cardpayments/v1/accounts/account_id/auths |
- Dans les exemples ci-dessus, remplacez id par l’identifiant unique du client renvoyé lors de la création du profil client.
- Certains points de terminaison d’API comportent plusieurs paramètres. Par exemple, une requête de recherche d’adresse nécessite un profile_id et un address_id.
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