Exemples de payloads Direct Charge

Utilisez ces modèles 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 généré par le client avant l’envoi de la requête.

Indications USSD

Orange Senegal : #144#391#
Orange Mali : #144#77#
Orange Burkina Faso : *144*4*6*amount#

En sandbox, n’importe quel code aléatoire à 6 chiffres peut être utilisé 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>"
  }
}

Référence des champs

Champ	Type	Requis	Notes
`reference`	string	Recommandé	Doit être unique par transaction
`amount`	integer	Oui	Valeur en sous-unités uniquement
`provider`	string	Oui	Utilisez le slug provenant des providers pris en charge
`webhook`	string	Non	Surcharge de webhook par requête
`narration`	string	Non	Note de transaction lisible par humain
`customerInput.phoneNumber`	string	Généralement oui	Format selon le provider et le pays
`customerInput.network`	string	Spécifique au provider	Requis pour certains flux comme le bank transfer
`customerInput.customerCode`	string	Spécifique au provider	Requis pour les flux Orange pre-OTP

Checklist de validation avant l’envoi

Format du montant

Envoyez uniquement des montants entiers en sous-unités. Les décimales ne sont pas prises en charge.

Slug provider

Assurez-vous que provider correspond a un slug valide de Providers pris en charge.

Champs `customerInput` requis

Confirmez la présence des champs spécifiques au provider, comme phoneNumber, network ou customerCode, avant d’envoyer la requête.

Unicite de la reference

Générez des références uniques afin d’éviter les erreurs de transaction en double.

Documentation associée

API Direct Charge

Flux de requête et gestion des réponses et actions.

Flux de traitement

Comportements processing, redirect, bankTransfer et pre-OTP.

Specification des montants

Règles de conversion en sous-unités pour tous les montants.

Premiers pas

Concepts clés

Prestataires et couverture

Développement

Encaisser des paiements

Décaissements

Exemples de payloads Direct Charge

Payload commun, la plupart des providers

Payload Orange pre-OTP

Indications USSD

Référence des champs

Checklist de validation avant l’envoi

Documentation associée

API Direct Charge

Flux de traitement

Specification des montants

​Payload commun, la plupart des providers

​Payload Orange pre-OTP

​Indications USSD

​Référence des champs

​Checklist de validation avant l’envoi

​Documentation associée

API Direct Charge

Flux de traitement

Specification des montants

Payload commun, la plupart des providers

Payload Orange pre-OTP

Indications USSD

Référence des champs

Checklist de validation avant l’envoi

Documentation associée