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/accountmanagement/v1/merchants - Point de terminaison d’API de production : https://api.paysafe.com/
Par exemple : https://api.paysafe.com/accountmanagement/v1/merchants
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 suivant :
https://api.test.paysafe.com/accountmanagement/v1/merchants/merchant_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. |
| merchant_id | Remplacez par votre identifiant unique de marchand, que vous avez reçu dans la réponse lorsque vous avez créé pour la première fois un marchand à intégrer sur votre plateforme. |
| APIrequest | Remplacez par le type de requête API, comme les marchands, les comptes marchands et les propriétaires d’entreprise. |
| 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 |
|---|---|---|
Marchands | Créer une entité de marchand Une fois le marchand créé, vous pouvez lui ajouter d’autres objets, tels qu’un compte marchand, un propriétaire de ce compte, des adresses et des informations sur le compte bancaire. | POST/accountmanagement/v1/merchants |
| Comptes marchands | Ajoutez un ou plusieurs comptes marchands à l’entité du marchand. | POST/accountmanagement/v1/merchants/merchant_id/accounts |
Utilisateurs | Ajoutez un utilisateur à un compte marchand. L’utilisateur pourra se connecter au Portail Paysafe pour ce compte. | POST/accountmanagement/v1/accounts/account_id/users |
Adresses associées à un compte marchand | Ajoutez une adresse pour le compte marchand. | POST/accountmanagement/v1/accounts/account_id/addresses |
| Propriétaires d’entreprise | Ajoutez un propriétaire d’entreprise pour chaque compte marchand que vous créez. | POST/accountmanagement/v1/accounts/account_id/businessowners |
| Adresses actuelles du propriétaire d’entreprise | Ajoutez une adresse pour le propriétaire de l’entreprise. Dans certains cas, une adresse actuelle et une adresse antérieure sont requises. | POST/accountmanagement/v1/businessowners/businessowner_id/currentaddresses |
| Adresses antérieures du propriétaire de l’entreprise | Ajoutez une adresse antérieure pour le propriétaire de l’entreprise, le cas échéant. | POST/accountmanagement/v1/businessowners/businessowner_id/previousaddresses |
Identité du propriétaire d’entreprise | Ajoutez une pièce d’identité à chaque propriétaire de l’entreprise. Le type de pièce d’identité requis dépend de la juridiction du propriétaire de l’entreprise. Par exemple, si le propriétaire de l’entreprise est canadien, vous pouvez ajouter un permis de conduire canadien comme pièce d’identité. | POST/accountmanagement/v1/businessowners/businessowner_id/canadiandrivinglicenses |
Compte bancaire marchand | Ajoutez un compte bancaire au compte marchand que vous avez créé. Le type de compte bancaire requis dépend de la juridiction du compte marchand. Par exemple, pour un compte marchand canadien, vous devez ajouter un compte bancaire canadien (TEF). | POST/accountmanagement/v1/accounts/account_id/eftbankaccounts |
| Conditions générales | Le marchand accepte les conditions générales de Paysafe, ce qui est nécessaire pour que le compte marchand puisse être activé. | POST/accountmanagement/v1/accounts/account_id/termsandconditions |
| Activation du compte marchand | Activez le compte marchand pour que le marchand puisse commencer à traiter des paiements avec Paysafe. | POST/accountmanagement/v1/accounts/account_id/activation |
| Micro-dépôt | Dans certaines juridictions, vous pouvez valider les détails d’un compte bancaire ACH ou TEF à l’aide d’un petit dépôt effectué par Paysafe sur ce compte bancaire. | POST/accountmanagement/v1/bank_scheme/bank_account_id/microdeposits |
| Transferts de solde | Transférez les soldes entre les comptes marchands liés, qu’il s’agisse de crédits ou de débits. | POST/accountmanagement/v1/accounts/account_id/credits POST/accountmanagement/v1/accounts/account_id/debits |
Dans les exemples ci-dessus, remplacez les instances de variables comme account_id, businessowner_id et merchant_id, avec l’identifiant unique renvoyé par Paysafe dans les réponses à leurs requêtes de création respectives.