Créer un nouveau compte marchand
POST /accountmanagement/v1/merchants/merchant_id/accounts
Une fois le marchand créé, vous pouvez commencer à ajouter des comptes marchands à ce marchand. Pour créer un compte de traitement marchand par carte de crédit ou par prélèvement automatique, vous devez initier une requête POST vers le point de terminaison des comptes. Le compte du marchand sera associé à l’identifiant marchand inclus dans le point de terminaison.
Vous devez créer un autre compte marchand (chacun d’entre eux ayant son propre productCode) pour chaque combinaison de mode de paiement et de devise que vous souhaitez proposer – p. ex. carte de crédit USD, prélèvement automatique TEF, etc.
Une fois le compte marchand créé, vous pouvez poursuivre la procédure, notamment en ajoutant le propriétaire, l’adresse du propriétaire et le compte bancaire de règlement pour chaque compte.
Vous devez attendre 5 secondes avant d’utiliser l’identifiant renvoyé dans la réponse de création du compte marchand dans tout appel ultérieur de l’API qui en a besoin (p. ex. mettre à jour le compte marchand).
curl -X POST https://api.test.paysafe.com/accountmanagement/v1/merchants/a5f1889d-f1be-4bbf-941d-fd9b8d09d5b1/accounts \
-u devcentre322:B-qa2-0-53625f86-302c021476f52bdc9deab7aea876bb28762e62f92fc6712d0214736abf501e9675e55940e83ef77f5c304edc7968 \
-H 'Content-Type: application/json' \
-d ' {
"name": "Popeye's Gym",
"currency": "CAD",
"region": "CA",
"legalEntity": "Popeye's Inc",
"productCode": "GOLD"
}'
Avant d’essayer l’exemple ci-dessus, vous devez :
- Remplacez le numéro de compte (89987201) dans l’URL par le numéro de compte de test que vous avez reçu.
- Remplacez la clé API (après le -u) par la clé API que vous avez reçue.
{
"id": "89987201",
"status": "DEFERRED",
"name": "Popeye's Gym",
"currency": "CAD",
"region": "CA",
"legalEntity": "Popeye's Inc",
"productCode": "GOLD",
"creationDate": "2015-01-20T12:12:56Z",
"links": [{
"rel": "self",
"href": "https://api.test.paysafe.com/accountmanagement/v1/merchants/a5f1889d-f1be-4bbf-941d-fd9b8d09d5b1/accounts/89987201"
}]
}
Voir notre rubrique Référence API pour une liste de tous les attributs et types JSON disponibles pour le point de terminaison des comptes.
Éléments du compte marchand obligatoires pour l’activation du compte
Lors de la création d’un compte marchand, seuls les éléments suivants sont obligatoires : nom, devise, région, entité légale et code de produit. Il s’agit de rendre les conditions de création de compte aussi minimes que possible. Toutefois, avant l’activation du compte marchand, les éléments suivants sont nécessaires, et vous devez mettre à jour le compte marchand pour les inclure :
- category
- phone
- yearlyVolumeRange
- averageTransactionAmount
- merchantDescriptor
Notez que le merchantDescriptor est lui-même un objet qui contient deux éléments – dynamicDescriptor et phone – qui sont tous deux obligatoires.
En outre, selon la juridiction dans laquelle vous intégrez des marchands, l’un des objets suivants est également obligatoire avant que vous ne puissiez activer le compte marchand :
- Canada – caAccountDetails, pour lesquels le type et le federalTaxNumber sont des éléments obligatoires.
- États-Unis – usAccountDetails, pour lesquels le type et le federalTaxNumber sont des éléments obligatoires.
- Europe – euAccountDetails, pour lesquels le type est obligatoire, et le registrationNumber est obligatoire à moins que la valeur pour le type ne soit définie sur TRUST, SOLEPROP, GOV ou PARTNERSHIP (auquel cas le registrationNumber est facultatif)
Comptes marchands multidevises
Si Paysafe vous a configuré pour créer des comptes marchands qui traitent dans une devise et règlent dans une autre, le paramètre processingCurrency est obligatoire, en plus du paramètre de devise. Dans ce cas :
- Le paramètre processingCurrency spécifie la devise dans laquelle le compte marchand traite les transactions.
- Le paramètre currency spécifie la devise dans laquelle le compte marchand règle les transactions.
Si Paysafe ne vous a pas configuré pour créer des comptes marchands qui traitent et règlent dans différentes devises, seul le paramètre de devise est inclus, qui détermine la devise unique utilisée pour le traitement et le règlement des transactions.
curl -X POST https://api.test.paysafe.com/accountmanagement/v1/merchants/a5f1889d-f1be-4bbf-941d-fd9b8d09d5b1/accounts \
-u devcentre322:B-qa2-0-53625f86-302c021476f52bdc9deab7aea876bb28762e62f92fc6712d0214736abf501e9675e55940e83ef77f5c304edc7968 \
-H 'Content-Type: application/json' \
-d ' {
"name": "Popeye's Mega Gym",
"processingCurrency": "USD",
"currency": "CAD",
"region": "CA",
"legalEntity": "Popeye's Corp",
"productCode": "GOLD"
}'
Si Paysafe ne vous a pas configuré pour créer des comptes multidevises, vous ne pouvez pas utiliser le paramètre de traitement de la devise.