Passer au contenu principal

Documentation Index

Fetch the complete documentation index at: https://docs.payfonte.com/llms.txt

Use this file to discover all available pages before exploring further.

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

ChampTypeRequisNotes
referencestringRecommandéDoit être unique par transaction
amountintegerOuiValeur en sous-unités uniquement
providerstringOuiUtilisez le slug provenant des providers pris en charge
webhookstringNonSurcharge de webhook par requête
narrationstringNonNote de transaction lisible par humain
customerInput.phoneNumberstringGénéralement ouiFormat selon le provider et le pays
customerInput.networkstringSpécifique au providerRequis pour certains flux comme le bank transfer
customerInput.customerCodestringSpécifique au providerRequis 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.
Assurez-vous que provider correspond a un slug valide de Providers pris en charge.
Confirmez la présence des champs spécifiques au provider, comme phoneNumber, network ou customerCode, avant d’envoyer la requête.
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.