Bien démarrer
Créer un compte
Inscrivez-vous, recevez votre organisation et ses clés de test, et repérez-vous dans le bac à sable.
Sur cette page
Un compte AdProMaxPay commence dans le bac à sable : vous vous inscrivez, et vos clés de test fonctionnent tout de suite. Rien à nous envoyer, rien à attendre, jusqu’au jour où vous voulez encaisser de vrais paiements.
S’inscrire
Ouvrez la page d’inscription et indiquez :
- votre prénom et votre nom ;
- votre adresse e-mail ;
- un mot de passe qui respecte les règles affichées sur le formulaire ;
- le nom de votre organisation : le nom de votre entreprise ;
- votre accord avec les conditions.
Ce que crée l’inscription
Une seule étape crée tout ce qu’il faut pour commencer :
- Votre compte utilisateur : la personne qui se connecte.
- Une organisation : votre entreprise sur AdProMaxPay. Chaque paiement, client, clé d’API,
endpoint de webhook et membre de l’équipe appartient à une seule organisation. Son identifiant
commence par
org_. - Votre place de Propriétaire : le rôle qui peut tout faire, y compris inviter votre équipe.
- Une paire de clés de test : une clé secrète et une clé publiable, pour le mode test.
L’organisation travaille au Maroc, en dirhams marocains (MAD), à l’heure du Maroc (le fuseau
Africa/Casablanca, qui ne change pas). Sa langue est le français tant que vous ne la changez pas,
sous Paramètres → Organisation.
Son statut est sandbox : l’activation_status que vous lisez dans
GET /v1/account. Il reste sandbox jusqu’à l’activation de votre compte
pour les paiements réels.
Votre bac à sable est prêt
Après l’inscription, la page Votre bac à sable est prêt affiche vos clés de test :
- la clé secrète de test,
apx_sk_test_…, affichée une seule fois. Copiez-la dans votre gestionnaire de secrets ou l’environnement de votre serveur, puis cochez « J’ai conservé cette clé en lieu sûr » pour activer Terminé ; - la clé publiable,
apx_pk_test_…, que vous pouvez revoir à tout moment sur la page des clés d’API.
Ensuite, Ouvrir votre tableau de bord vous mène à votre organisation en mode test, et Lire le démarrage rapide ouvre le démarrage rapide carte. Votre première requête est dans Vos clés d’API.
Clé secrète perdue avant de la conserver ? AdProMaxPay n’en garde qu’une empreinte et ne peut pas l’afficher de nouveau. Créez-en une autre sous Développeurs → Clés d’API, puis révoquez la première. Une organisation détient par défaut 2 clés secrètes actives et 2 clés publiables par mode.
Le mode test dans le tableau de bord
Tant que vous travaillez en mode test, le tableau de bord l’indique à plusieurs endroits à la fois :
- un bandeau Mode test sous la barre du haut ;
- un bord rayé le long de la navigation ;
/test/dans l’adresse de la page ;[TEST]au début du titre de l’onglet ;- une pastille TEST à côté de chaque identifiant.
Le côté production du sélecteur de mode reste désactivé, avec « Les paiements réels s’ouvrent après l’activation ». Ce que demande l’activation, et ce qu’il faut vérifier avant de basculer, est dans la liste de contrôle avant la production.
Vérifier votre e-mail
AdProMaxPay envoie un code à votre adresse e-mail. Saisissez-le sur la page qu’ouvre le bandeau. Un bandeau reste sur le tableau de bord tant que votre e-mail n’est pas vérifié. Vous pouvez demander un nouveau code après une minute, jusqu’à dix fois par jour.
Le bac à sable fonctionne sans : vous pouvez d’abord construire et tester toute votre intégration. Un e-mail vérifié est nécessaire avant l’activation, et avant d’inviter votre équipe.
Protéger votre connexion
La vérification en deux étapes ajoute à votre mot de passe un code d’une application d’authentification. Elle est facultative dans le bac à sable et conseillée dès le premier jour ; elle sera exigée pour passer en production. Voir Sécurité.
Plus d’une entreprise
Une organisation correspond à une entreprise. Pour une deuxième entreprise, ouvrez le sélecteur d’organisation en haut de la navigation et choisissez Créer une organisation. Chaque organisation a ses clés, ses données, son équipe, ses limites et son activation, et rien ne passe de l’une à l’autre.
- Vous pouvez être propriétaire de 20 organisations au plus.
- Vous pouvez aussi être membre d’autres organisations, quand un Propriétaire ou un Administrateur de celles-ci vous invite.
- Le sélecteur vous fait passer de l’une à l’autre et garde la section où vous êtes : des paiements d’une organisation aux paiements de l’autre.
Pour faire entrer vos collègues, voir Équipe et rôles.
L’identifiant de votre organisation
L’identifiant de votre organisation (org_…) vous sert quand vous écrivez au support ou configurez un
outil. Vous le trouvez :
- dans le sélecteur d’organisation, avec Copier l’identifiant de l’organisation ;
- sous Paramètres → Organisation ;
- dans
id, dans la réponse deGET /v1/account.
Paramètres → Organisation contient aussi Supprimer toutes les données de test, en mode test seulement : l’action efface vos paiements de test, vos clients et le reste de vos objets de test, et garde vos clés et votre équipe.
Et ensuite
- Vos clés d’API : envoyez votre première requête.
- Démarrage rapide : paiement par carte avec la page hébergée.
- Démarrage rapide : paiement en espèces.