Bien démarrer

Créer un compte

Inscrivez-vous, vérifiez votre e-mail, générez vos 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. Vérifier votre e-mail
  4. Votre bac à sable est prêt
  5. Le mode test dans le tableau de bord
  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, vous vérifiez votre adresse e-mail, et vous générez vous-même vos clés de test. 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 votre place sur AdProMaxPay :

  • 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.

Elle ne crée aucune clé d’API. Vous générez vous-même vos clés de test, une fois votre e-mail vérifié : une clé secrète n’existe que parce que vous l’avez demandée, et vous êtes la seule personne à la voir.

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.

Vérifier votre e-mail

L’inscription envoie un code à 6 chiffres à votre adresse e-mail et ouvre la page Consultez votre e-mail. Saisissez-y le code, puis Vérifier l’e-mail. Votre bac à sable s’ouvre une fois le code accepté : d’ici là, le tableau de bord n’affiche que cette page.

  • Le code est valable 15 minutes, et pour cinq essais.
  • Rien dans votre boîte de réception ? Regardez dans vos courriers indésirables, ou utilisez Envoyer un nouveau code : après une minute, et jusqu’à dix fois par jour. Un nouveau code remplace le précédent.
  • Déconnecté avant de l’avoir saisi ? Reconnectez-vous : la même page s’ouvre.
  • Mauvaise adresse ? Se déconnecter et recommencer avec la bonne.

Invité dans une organisation ? Le lien de l’invitation a déjà prouvé votre adresse : il n’y a pas de code à saisir.

Votre bac à sable est prêt

Une fois votre e-mail vérifié, la page Votre bac à sable est prêt propose Générer ma clé secrète de test. Générez-la quand vous êtes prêt à la ranger :

  • la clé secrète de test, apx_sk_test_…, est 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_…, est créée avec elle. Vous pouvez la revoir à tout moment sur la page des clés d’API.

Je le ferai plus tard passe l’étape : vous pouvez créer vos clés à tout moment sous Développeurs → 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.

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. Une nouvelle organisation commence sans clé, comme la première : créez-les sous Développeurs → Clés d’API.

  • 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