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.

Ouvrir en Markdown
Sur cette page
  1. S’inscrire
  2. Ce que crée l’inscription
  3. Votre bac à sable est prêt
  4. Le mode test dans le tableau de bord
  5. Vérifier votre e-mail
  6. Protéger votre connexion
  7. Plus d’une entreprise
  8. L’identifiant de votre organisation
  9. Et ensuite

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 de GET /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