POST
/
direct-pay
Initier une Demande de Paiement Direct
curl --request POST \
  --url https://sandbox.fapshi.com/direct-pay \
  --header 'Content-Type: application/json' \
  --header 'apikey: <api-key>' \
  --header 'apiuser: <api-key>' \
  --data '{
  "amount": 101,
  "phone": "<string>",
  "medium": "mobile money",
  "name": "<string>",
  "email": "jsmith@example.com",
  "userId": "<string>",
  "externalId": "<string>",
  "message": "<string>"
}'
{
  "message": "<string>",
  "transId": "<string>",
  "dateInitiated": "2023-12-25"
}

​
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.

​
Paramètres

NomObligatoireTypeDescription
amountOuientierMontant à payer (minimum 100 XAF).
phoneOuichaîneNuméro de téléphone pour la demande de paiement (exemple : 67XXXXXXX).
mediumNonchaîne"mobile money" ou "orange money". À omettre pour détection automatique.
nameNonchaîneNom du payeur.
emailNonchaîneEmail du payeur pour recevoir le reçu.
userIdNonchaîneID utilisateur dans votre système (1–100 caractères; a–z, A–Z, 0–9, -, _ autorisés).
externalIdNonchaîneID de transaction ou commande pour rapprochement (1–100 caractères; mêmes règles).
messageNonchaîneMotif du paiement.

​
Réponse

  • 200 OK avec un corps JSON contenant :

    • message : message de succès
    • transId : ID de la transaction pour suivre le paiement
    • dateInitiated : date de l’initiation du paiement

  • En cas d’erreur, un code 4XX avec un message d’échec est retourné.

Le paiement direct est désactivé par défaut en environnement live ; contactez le support pour activation.
Manipulez cet endpoint avec précaution ; toute mauvaise utilisation peut entraîner la suspension de votre compte.

Authorizations

​
apiuser
string
header
required
​
apikey
string
header
required

Body

application/json

Response

200
application/json

Accepté

The response is of type object.