Payments · Disponible

Encaissez le Mobile Money
avec une seule API.

MTN, Moov, Celtiis, Orange et Wave réunis derrière un seul objet Payment. Intégrable en bac à sable dès aujourd’hui — les cartes Visa & Mastercard arrivent, sans changer votre intégration.

Opéré via des établissements agréés par la BCEAO. GoroPay ne détient pas les fonds des payeurs.

Réseaux Mobile Money
Visa · Mastercardbientôt
Ce que fait Payments

Tout l’encaissement, pensé comme une infrastructure

Les garanties d’un rail financier — idempotence, signatures, statuts explicites — imposées au niveau de la base.

Disponible

Mobile Money, 5 réseaux

MTN MoMo, Moov Money, Celtiis Cash, Orange Money et Wave — une seule intégration pour les encaisser tous.

Bientôt

Cartes Visa & Mastercard

Encaissement par carte, avec tokenisation déléguée à un partenaire certifié PCI DSS. Aucune donnée sensible ne transite par vos serveurs.

Disponible

Une API unique

Un seul objet Payment, conçu pour tous les moyens de paiement. Vous codez une fois ; les nouveaux réseaux s’ajoutent sans changer votre intégration.

Disponible

Idempotence native

Chaque requête porte une clé d’idempotence. Un retry réseau ne créera jamais un double débit — c’est un standard, pas une option.

Disponible

Webhooks signés

Signature HMAC-SHA256 et rejeu automatique pendant 72 h. Votre serveur peut tomber : l’événement vous attend et se vérifie.

Disponible

Sandbox réaliste

Des numéros de test qui simulent succès, refus et paiements en attente. Développez votre tunnel complet sans dépenser un franc.

Disponible

Statuts clairs

Un cycle de vie explicite — pending, requires_action, processing, succeeded, failed, refunded — au lieu de codes opaques à deviner.

Disponible

XOF natif

Des montants en francs CFA, jamais convertis. Le ledger en double entrée trace chaque mouvement au franc près.

Une requête suffit

Créez un paiement en un appel

Le même corps de requête fonctionne en test et en production : seule la clé change. La clé d’idempotence garantit qu’un retry ne débitera jamais deux fois.

  • Montants en XOF, sans conversion cachée
  • Réponse immédiate avec identifiant et statut
  • Suite du cycle de vie livrée par webhook signé
Référence de l’API
Terminal — POST /v1/payments
curl https://api.goropay.com/v1/payments \
  -H "Authorization: Bearer sk_test_..." \
  -H "Idempotency-Key: pay_a1b2c3d4" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 15000,
    "currency": "XOF",
    "description": "Sandales artisanales — cuir",
    "payment_method": {
      "type": "mobile_money",
      "operator": "mtn",
      "phone": "+22901970000001"
    },
    "callback_url": "https://gorogoo.com/webhooks/goropay"
  }'
Réponse — 201 Created
{
  "id": "pay_3nKQ8vZ2xR",
  "status": "pending",
  "amount": 15000,
  "currency": "XOF",
  "livemode": false
}
Cycle de vie

Des statuts que l’on peut lire

Chaque paiement suit une machine à états explicite. Vous savez toujours où en est un franc.

pending

Le paiement est créé et attend une action du payeur — typiquement la validation du code Mobile Money sur son téléphone.

requires_action

Une étape d’authentification est nécessaire côté payeur (saisie de code USSD, confirmation de l’opérateur) avant de poursuivre.

processing

Le payeur a confirmé ; la transaction est en cours de règlement auprès de l’opérateur. Aucune action de votre part.

succeeded

Les fonds sont confirmés par l’établissement agréé et crédités au solde tenu à votre nom chez le partenaire ; ils apparaissent dans votre dashboard. C’est l’état final positif : livrez le bien ou le service.

failed

Le paiement a échoué — solde insuffisant, refus de l’opérateur ou expiration. Le motif est renvoyé dans un message lisible.

refunded

Un remboursement total a été renvoyé au payeur. Le ledger conserve les deux écritures, l’encaissement et le retour.

En 3 étapes

De la requête au solde crédité

1

Créez le paiement

Un POST /v1/payments avec le montant, la devise et le moyen de paiement. Vous recevez un identifiant et un statut immédiat.

2

Le client confirme

Il valide sur son téléphone via Mobile Money — ou bientôt saisit sa carte sur une page tokenisée par notre partenaire PCI DSS.

3

Vous êtes notifié

Un webhook signé vous informe du passage à succeeded. Votre solde, tenu chez l’établissement agréé partenaire, est crédité, et chaque mouvement est prouvé au franc près dans le ledger.

Encaissez votre premier paiement

Créez votre compte, récupérez votre clé de test et acceptez un paiement Mobile Money en sandbox dès aujourd’hui — en moins d’une heure.