Démarrage rapide - iPayMoney

Ce guide crée un paiement Sandbox, puis vérifie son statut. Il utilise l’API REST depuis un serveur ou un terminal afin de ne jamais exposer la clé secrète dans le navigateur.

1. Récupérer les clés Sandbox

Connectez-vous au dashboard iPayMoney, ouvrez Développeurs → Clés API et copiez la clé secrète du compte Sandbox. Conservez-la dans une variable d’environnement :

export IPAYMONEY_SECRET_KEY="votre_cle_secrete_sandbox"

2. Créer un paiement de test

curl --request POST "https://i-pay.money/api/v1/payments" \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer ${IPAYMONEY_SECRET_KEY}" \
  --header "Ipay-Target-Environment: sandbox" \
  --header "Ipay-Payment-Type: mobile" \
  --data '{
    "amount": 1000,
    "country": "BJ",
    "currency": "XOF",
    "msisdn": "40410000000",
    "transaction_id": "ORDER-SANDBOX-001",
    "customer_name": "Client Test"
  }'

transaction_id doit être unique pour votre compte. Une valeur déjà utilisée provoque une réponse 422. La réponse HTTP 200 contient notamment les références à conserver :

{
  "status": "succeeded",
  "reference": "REFERENCE_IPAYMONEY",
  "public_reference": "REFERENCE_PUBLIQUE"
}

Note : le champ status de la réponse de création ne doit pas être votre seule preuve de paiement. Vérifiez toujours le statut avec l’endpoint de consultation ou avec un webhook authentifié.

3. Vérifier le statut

curl --request GET "https://i-pay.money/api/v1/payments/REFERENCE_IPAYMONEY" \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer ${IPAYMONEY_SECRET_KEY}" \
  --header "Ipay-Target-Environment: sandbox" \
  --header "Ipay-Payment-Type: mobile"

Vous pouvez utiliser la reference iPayMoney ou votre transaction_id. Ne validez une commande que lorsque la réponse de vérification contient status: succeeded.

Étapes suivantes