API de paiement mobile money pour Madagascar

Authentification

Toutes les requetes API utilisent une cle API envoyee dans le header X-Api-Key. Les cles sont creees depuis les parametres du compte Gateway.

curl -H "X-Api-Key: YOUR_API_KEY" \
  https://cashpoint.aiai.mg/api/v1/gateway/payments

URL de base

https://cashpoint.aiai.mg/api/v1/gateway

POST /payments

Cree une demande de paiement et retourne un lien que vous pouvez envoyer au client par SMS, WhatsApp, email ou afficher dans votre application.

{
  "amount": 50000,
  "receiving_phone": "0341234567",
  "customer_phone": "0349876543",
  "description": "Commande #1234",
  "client_ref": "order_1234",
  "callback_url": "https://example.com/webhooks/cashpoint",
  "expires_in": 900
}

{
  "id": 42,
  "referenceCode": "PAY-A7X3",
  "status": "PENDING",
  "amount": 50000,
  "expiresAt": "2026-03-20T10:15:00Z",
  "checkoutUrl": "https://cashpoint.aiai.mg/pay/PAY-A7X3"
}

GET /payments/{reference_code}

Recupere le statut d'une demande de paiement par son code de reference. Les statuts principaux sont PENDING, PAID, EXPIRED et CANCELLED.

{
  "referenceCode": "PAY-A7X3",
  "status": "PAID",
  "amount": 50000,
  "receivedAmount": 50000,
  "paidAt": "2026-03-20T10:12:00Z"
}

POST /payments/{reference_code}/cancel

Annule une demande de paiement en attente. Un paiement deja confirme ne peut plus etre annule.

Webhooks

Les webhooks notifient votre systeme en temps reel quand un paiement change d'etat. Les evenements importants sont payment.received et payment.expired.

{
  "event": "payment.received",
  "referenceCode": "PAY-A7X3",
  "amount": 50000,
  "receivedAmount": 50000,
  "clientRef": "order_1234",
  "customerPhone": "0349876543",
  "paidAt": "2026-03-20T10:12:00Z"
}