Gestion des commerçants
Gérez les brouillons d’onboarding, les invitations à l’inscription, les accès des commerçants et les tarifs contractuels depuis votre backend.
Gérez les commerçants de votre organisation depuis votre backend. Chaque appel utilise votre Server Secret Token : conservez-le donc sur votre serveur.
| Détail | Valeur |
|---|---|
| URL de base | https://api.sandbox.tapaya.com pour la sandbox, https://api.tapaya.com pour la production |
| Authentification | Server Secret Token dans Authorization. Consultez Authentification. |
| Montants | Unités monétaires mineures : 2500 avec EUR correspond à 25,00 EUR. Frais relatifs en points de base : 100 correspond à 1 %. |
| Guide associé | Onboarding des commerçants |
Toutes les opérations
| Opération | À utiliser pour |
|---|---|
| Lire un onboarding enregistré | Reprendre le formulaire d’onboarding d’un commerçant là où il s’est arrêté. |
| Enregistrer les canaux sélectionnés | Stocker les canaux de paiement choisis par un commerçant, sans soumettre la demande. |
| Lister les membres | Voir qui a déjà accès à un commerçant. |
| Lister les terminaux | Afficher les terminaux d’un commerçant et leurs appareils. |
| Lister les invitations par e-mail | Suivre les invitations à usage unique envoyées à des destinataires connus. |
| Lister les liens réutilisables | Suivre les liens de campagne et savoir s’ils sont suspendus. |
| Créer un lien réutilisable | Lancer une campagne par laquelle de nombreux commerçants peuvent s’inscrire. |
| Modifier l’expiration d’une invitation | Prolonger ou raccourcir une invitation, même expirée. |
| Suspendre ou réactiver un lien réutilisable | Bloquer temporairement les nouvelles inscriptions sans révoquer le lien. |
| Lister les ensembles tarifaires | Trouver les ensembles tarifaires à partir desquels votre organisation peut créer des profils. |
| Lister les profils de commission | Choisir un profil à attribuer à une invitation. |
| Créer un profil de commission | Proposer aux commerçants une liste tarifaire créée à partir d’un ensemble tarifaire. |
| Mettre à jour un profil de commission | Renommer un profil ou modifier ses tarifs. |
| Supprimer un profil de commission | Supprimer un profil que vous ne proposez plus. |
| Définir le profil par défaut | Choisir le profil utilisé par les invitations qui n’en désignent aucun. |
| Lire les tarifs du commerçant | Afficher les tarifs souscrits par un commerçant. |
Brouillons d’onboarding
Membres et terminaux
Invitations à l’inscription
Utilisez une invitation par e-mail pour un destinataire connu, ou un lien réutilisable pour une campagne. Les deux permettent de restreindre les canaux et d’attribuer des profils de commission.
Profils de commission
Un profil de commission est la liste tarifaire que vous proposez aux commerçants. Créez-le à partir d’un ensemble tarifaire pour lequel votre organisation est autorisée.
Tarifs du commerçant
Erreurs
Chaque opération renvoie ces codes de statut lorsqu’une requête échoue.
| Code | Description |
|---|---|
400 | Données de canal, sélection de profils, filtres ou expiration invalides, ou suppression d’un profil par défaut ou attribué. |
401 | Le Server Secret Token est absent ou invalide. |
404 | La ressource n’est pas accessible à votre organisation, ou l’onboarding ou les tarifs enregistrés n’existent pas. |
409 | Révision de profil obsolète, état d’onboarding conflictuel, ou invitation utilisée ou révoquée. |