Activer le module

Deux clés. Une clé d'intégrateur sk_int_* pilote votre espace : inviter vos clients, suivre leur enrôlement, retirer leurs clés, déclarer vos adresses de réception. Elle s'émet depuis Intégrateur, Clients, une fois votre espace intégrateur validé par Mobupay. La clé que vous détenez pour chaque client, une clé sk_live_ de son compte, encaisse en son nom.

1D'abord, obtenir votre espace intégrateur

Le mode intégrateur ne s'active pas seul : c'est Mobupay qui ouvre votre espace intégrateur, puis le valide. Si vous ouvrez votre compte, cochez Devenir intégrateur dès la première étape de l'inscription, sous « Devenir agence partenaire » : la case paraît quand vous encaissez sur votre site ou pour d'autres vendeurs. Si votre compte est déjà ouvert, demandez-le à Mobupay. Une fois votre espace validé, l'onglet Intégrateur apparaît dans votre espace marchand.

Demander l'espace intégrateur

2Ensuite, une fois votre espace validé, créez la clé de votre logiciel.

Créer une clé d'intégrateur

Intégrateur, Clients, section Accès API : vos clés d'intégrateur et vos adresses de réception. S'ouvre dans un nouvel onglet.

Ce que le compte doit porter

1Un compte Mobupay ouvert, et un espace intégrateur validé par Mobupay : il se demande dès la première étape de l'inscription (case « Devenir intégrateur »), ou il est ouvert par Mobupay.
2Une clé sk_int_test_* pour recetter en simulation, sk_int_live_* pour le réel.
3Pour encaisser : l'autorisation de votre client, donnée à la soumission de son dossier, sans laquelle aucune clé n'est générée pour vous.

Si la condition n'est pas remplie

Une clé qui n'est pas une clé d'intégrateur répond 403 INTEGRATOR_KEY_REQUIRED sur les endpoints integrator/*, et une clé d'intégrateur présentée ailleurs 403 INTEGRATOR_KEY_OWN_ROUTES_ONLY. Un espace suspendu par Mobupay voit ses clés refusées, les vôtres comme celles que vous détenez, en 403 INTEGRATOR_SUSPENDED : elles reviennent à la réactivation. Une clé détenue dont votre client a coupé l'accès répond 401 KEY_HOLDER_ACCESS_REVOKED : elle ne reviendra pas.

Par où entrer

POSTInviter un client à ouvrir son compte/api/v1/integrator/clients/invitationsGETLister vos clients intégrés/api/v1/integrator/clientsPOSTRetirer le secret d'une clé détenue/api/v1/integrator/clients/{merchantId}/api-keys/{keyId}/reveal

Guides de recettes

Encaisser pour un client, de l'invitation au premier paiement6 étapes

Une clé `sk_int_*` invite votre client et retire la clé que vous détenez pour lui ; c'est elle qui encaisse, avec votre commission. Voici l'ordre des appels, et comment tout recetter en simulation.