Retraits

Envoyer de l’argent (retrait)

Envoyez de l’argent vers le compte Mobile Money d’un client : remboursement, gain, paiement d’un fournisseur… Le montant est prélevé sur votre portefeuille Nebryon.

Comment ça marche

Votre portefeuille est débité immédiatement de amount + fee.
Le transfert est exécuté vers le numéro du bénéficiaire ; le résultat arrive par webhook, généralement en moins d’une minute.
En cas d’échec (withdrawal.failed), votre portefeuille est remboursé intégralement.

Parcours

Votre serveur          Nebryon Pay
     │ POST /gatewaytransaction/api/withdrawal
     │ ─▶ portefeuille débité (montant + frais), retrait PENDING
     │    ─▶ exécution du transfert vers le numéro du bénéficiaire
     │◀── webhook withdrawal.succeeded
     │    ou withdrawal.failed (portefeuille remboursé)

Requête

POST/gatewaytransaction/api/withdrawalX-API-Key

Champ	Type	Description
amount *	nombre	Montant reçu par le bénéficiaire, de 100 à 1 000 000 XOF
phoneNumber *	texte	Numéro Mobile Money du bénéficiaire
network *	texte	Réseau du bénéficiaire
externalReference	texte	Recommandé : votre référence unique, qui évite d’envoyer deux fois l’argent en cas de nouvel essai
description	texte	Libellé libre
callbackMode	texte	`WEBHOOK` ou `WEBSOCKET`

curl

curl -X POST "https://paygate.nebyron.com/management/gatewaytransaction/api/withdrawal" \
  -H "X-API-Key: $NEBRYON_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 15000,
    "phoneNumber": "+22675443322",
    "network": "ORANGE_MONEY",
    "externalReference": "RET-778",
    "description": "Remboursement commande 1040"
  }'

Réponse 202 Accepted

202 signifie accepté, pas encore exécuté. Ici, le portefeuille est débité de 15 300 XOF (montant + frais).

withdrawal.under_review : l’opérateur n’a pas confirmé l’opération à temps, Nebryon la vérifie manuellement. Ne relancez pas le retrait : withdrawal.succeeded ou withdrawal.failed suivra.

Réponse · 202

{
  "id": "2126016f-07d5-4570-b090-11b6509843ca",
  "reference": "WDR261005DOE0PURTWL",
  "externalReference": "RET-778",
  "type": "WITHDRAWAL",
  "status": "PENDING",
  "amount": 15000.0,
  "fee": 300.0,
  "currency": "XOF",
  "network": "ORANGE_MONEY",
  "phoneNumber": "+22675443322",
  "description": "Remboursement commande 1040",
  "callbackMode": "WEBHOOK",
  "expiresAt": "2026-10-05T17:50:30.853319",
  "operatorReference": null,
  "failureReason": null,
  "completedAt": null,
  "createdAt": "2026-10-05T17:40:30.853363"
}

Tester en SandBox

Avec votre clé pk_test_, l’opération est simulée : un numéro finissant par 0001 échoue, 0002 passe en vérification puis réussit, tout autre réussit. Tous les scénarios

Erreurs

HTTP	cause	Cas
400	`BAD_REQUEST`	Montant hors limites, numéro ou réseau manquant
403	`ACCOUNT_NOT_VERIFIED`	Votre compte partenaire n’est pas encore vérifié
409	`INSUFFICIENT_FUNDS`	Solde insuffisant : rien n’est débité
503	`OPERATOR_DISABLED`	Opérateur momentanément indisponible : rien n’est débité