Démarrer

Ce que fait l'API, l'URL de base, votre première requête.

URL de base

Tous les points d'entrée sont préfixés par /api/v1 et répondent en JSON.

https://maticorp.tech/api/v1

Votre première requête

Le solde est le point d'entrée le plus simple : il ne crée rien et confirme que votre clé fonctionne.

curl https://maticorp.tech/api/v1/balance \
  -H "Authorization: Bearer VOTRE_CLE_API"

{
  "object": "balance",
  "available": 1450,
  "pending": 0,
  "frozen": 0,
  "currency": "XOF"
}

Les montants sont des entiers

Tout montant s'exprime en francs CFA entiers, jamais en décimales. 1450 vaut mille quatre cent cinquante francs. Le franc CFA n'a pas de subdivision en usage, et un montant en virgule flottante finit toujours par perdre un franc quelque part.

Ce que l'API sait faire

• Encaisser — créer un lien de paiement, ou prélever directement un numéro mobile money.
• Débourser — envoyer des fonds depuis votre solde vers un numéro.
• Fractionner — simuler un échéancier, le créer, suivre ses échéances.
• Être notifié — recevoir un webhook à chaque changement d'état.

Un principe à connaître avant d'intégrer

Une réponse HTTP 2xx ne veut pas dire que l'argent a bougé. Chez l'opérateur mobile money, une demande acceptée est une demande reçue : le client doit encore la valider sur son téléphone, et il peut refuser, ne rien faire, ou manquer de solde.

Un encaissement naît donc en attente et se dénoue plus tard. Attendez le webhook, ou relisez le paiement — ne considérez jamais une création réussie comme un paiement reçu. De notre côté, nous appliquons la même règle : le statut d'une opération est établi en réinterrogeant l'opérateur, jamais d'après le corps d'un rappel.