Initier une Demande de Paiement Direct
Points de terminaison
Initier une demande de paiement direct
Envoyez une demande de paiement directement sur le mobile d’un utilisateur.
POST
Initier une Demande de Paiement Direct
Documentation Index
Fetch the complete documentation index at: https://docs.fapshi.com/llms.txt
Use this file to discover all available pages before exploring further.
Endpoint
POST /direct-pay
Envoyez une demande de paiement directement sur le mobile d’un utilisateur. Vous êtes responsable de la création de votre propre formulaire de paiement et de la vérification du statut du paiement.
Les transactions de paiement direct ne peuvent et ne s’expirent pas. Par
conséquent, leur état final est soit SUCCESSFUL soit FAILED.
Manipulez ce point de terminaison avec précaution ; toute mauvaise utilisation
peut entraîner la suspension de votre compte.
Paramètres
| Nom | Obligatoire | Type | Description |
|---|---|---|---|
| amount | Oui | entier | Montant à payer (minimum 100 XAF). |
| phone | Oui | chaîne | Numéro de téléphone pour la demande de paiement (exemple : 67XXXXXXX). |
| medium | Non | chaîne | "mobile money" ou "orange money". À omettre pour détection automatique. |
| name | Non | chaîne | Nom du payeur. |
| Non | chaîne | Email du payeur pour recevoir le reçu. | |
| userId | Non | chaîne | ID utilisateur dans votre système (1–100 caractères; a–z, A–Z, 0–9, -, _ autorisés). |
| externalId | Non | chaîne | ID de transaction ou commande pour rapprochement (1–100 caractères; mêmes règles). |
| message | Non | chaîne | Motif du paiement. |
Réponse
-
200 OKavec un corps JSON contenant :message: message de succèstransId: ID de la transaction pour suivre le paiementdateInitiated: date de l’initiation du paiement
- En cas d’erreur, un code 4XX avec un message d’échec est retourné.
Corps
application/json
Montant à payer (minimum 100 XAF).
Plage requise:
x >= 100Numéro de téléphone où la demande de paiement est envoyée.
Moyen de paiement (facultatif).
Options disponibles:
mobile money, orange money Nom du payeur (facultatif).
Email du payeur pour les reçus (facultatif).
Identifiant interne de l'utilisateur (facultatif).
Pattern:
^[a-zA-Z0-9\-_]{1,100}$Identifiant de transaction/commande pour la réconciliation (facultatif).
Pattern:
^[a-zA-Z0-9\-_]{1,100}$Motif du paiement (facultatif).