Paiement direct par prompt USSD

Par défaut, POST /payments renvoie un lien de redirection (redirectUrl). Pour le mobile money, vous pouvez à la place déclencher un prompt USSD directement sur le téléphone du client, sans lien à ouvrir : il confirme le paiement depuis la fenêtre qui s'affiche sur son propre téléphone.

curl -X POST https://api.passerelle.abecedaire.tg/payments \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 1000,
    "customerName": "Jane Doe",
    "customerPhone": "+22890123456",
    "transactionType": "USSD_PROMPT",
    "operator": "T-Money"
  }'

{
  "reference": "pay_1a2b3c4d-...",
  "status": "pending"
}

Pas de redirectUrl dans la réponse : le client reçoit directement le prompt sur son téléphone.

Champs spécifiques

Champ	Requis	Effet
`transactionType`	non (défaut `REDIRECT_LINK`)	`USSD_PROMPT` pour ce mode
`operator`	oui pour les numéros hors Togo, déduit automatiquement sinon	Réseau mobile money du client (ex. `Flooz`, `T-Money`)

Pour un numéro togolais, Passerelle déduit operator automatiquement depuis le préfixe du numéro (portabilité non prise en compte) — vous pouvez toujours le préciser vous-même, ce qui prime sur la déduction. Pour les autres pays, operator est requis.

Ce mode n'est disponible qu'en MOBILE_MONEY — paymentMethod: "CARD" avec USSD_PROMPT renvoie une erreur 400. Seuls les partenaires de paiement qui supportent ce mode sont considérés pour l'itinéraire de cette requête ; jamais de repli silencieux vers un lien de paiement classique.

Champs spécifiques​

Champs spécifiques