Passer au contenu principal
Utilisez ces modeles de payload lorsque vous appelez : POST /payments/v1/payments/direct-charge

​
Payload commun, la plupart des providers

{
  "reference": "ORDER-1001",
  "amount": 10000,
  "provider": "mtn-momo-ivory-coast",
  "webhook": "https://yourapp.com/webhooks/payfonte",
  "narration": "Order payment",
  "customerInput": {
    "phoneNumber": "2250512345678"
  }
}

​
Payload Orange pre-OTP

Les providers Orange peuvent exiger un code genere par le client avant l’envoi de la requete.

​
Indications USSD

  • Orange Senegal : #144#391#
  • Orange Mali : #144#77#
  • Orange Burkina Faso : *144*4*6*amount#
En sandbox, n’importe quel code aleatoire a 6 chiffres peut etre utilise pour les tests. 
{
  "reference": "ORDER-1003",
  "amount": 10000,
  "provider": "orange-senegal",
  "webhook": "https://yourapp.com/webhooks/payfonte",
  "narration": "Order payment",
  "customerInput": {
    "phoneNumber": "786175702",
    "customerCode": "<6-digit-code>"
  }
}

​
Reference des champs

ChampTypeRequisNotes
referencestringRecommandeDoit etre unique par transaction
amountintegerOuiValeur en sous-unites uniquement
providerstringOuiUtilisez le slug provenant des providers pris en charge
webhookstringNonSurcharge de webhook par requete
narrationstringNonNote de transaction lisible par humain
customerInput.phoneNumberstringGeneralement ouiFormat selon le provider et le pays
customerInput.networkstringSpecifique au providerRequis pour certains flux comme le bank transfer
customerInput.customerCodestringSpecifique au providerRequis pour les flux Orange pre-OTP

​
Checklist de validation avant l’envoi

Format du montant

Envoyez uniquement des montants entiers en sous-unites. Les decimales ne sont pas prises en charge.
Assurez-vous que provider correspond a un slug valide de Providers pris en charge.
Confirmez la presence des champs specifiques au provider, comme phoneNumber, network ou customerCode, avant d’envoyer la requete.
Generez des references uniques afin d’eviter les erreurs de transaction en double.

​
Documentation associee

API Direct Charge

Flux de requete et gestion des reponses et actions.

Flux Mobile Money

Comportements processing, redirect et pre-OTP.

Specification des montants

Regles de conversion en sous-unites pour tous les montants.