Démarrage

Il n'existe pas de sandbox

C'est le point le plus important de cette documentation, et il n'a pas d'atténuation. sk_test_ et sk_live_ sont deux préfixes de clé fonctionnellement identiques : le mode d'une clé n'est lu nulle part dans le chemin de paiement. Il n'existe ni environnement de test, ni numéro de test, ni opérateur simulé.

Toute requête sur POST /v1/pay-in déclenche une sollicitation réelle — push, USSD ou SMS — vers le numéro que vous indiquez, et tout paiement abouti déplace de l'argent réel. Une clé sk_test_ ne vous protège de rien.

Conséquence directe pour votre intégration : vos tests automatisés ne doivent pas appeler POST /v1/pay-in. Bouchonnez-le. Les endpoints de découverte (/v1/corridors/available, /v1/countries, /v1/operators) sont en lecture seule et se testent sans risque.

Premier paiement

1. Créez une clé d'API dans le tableau de bord az54 — voir Authentification.
2. Appelez GET /v1/corridors/available?phone=…&transactionType=payin avec le numéro que vous allez utiliser. La réponse vous donne les opérateurs disponibles, la devise, le decimalPlaces de cette devise et surtout minAmountMajor : le montant minimum acceptable.
3. Postez un pay-in au montant minimum du corridor, vers un numéro dont vous possédez physiquement le combiné. Vous devrez valider la sollicitation dessus.
4. Attendez la notification sortante. Elle porte l'issue du paiement.

Le point 4 n'est pas facultatif : avec une clé d'API, il n'existe aucun autre moyen fiable de connaître l'issue d'un paiement. GET /v1/transactions exige un jeton de session, le flux SSE aussi, et le reçu public est plafonné à un niveau qui exclut le polling serveur. Configurez le webhook sortant avant votre premier appel.

Ce que cette documentation ne couvre pas

Elle décrit la surface accessible avec une clé d'API d'organisation. Les liens de paiement, le flux SSE de suivi temps réel, la gestion des utilisateurs et tout ce qui est préfixé /v1/admin/ sont des surfaces internes az54 : ils ne font pas partie du contrat public et peuvent changer sans préavis.