Référence de l'API

Pont expose trois familles de routes. Chaque page ci-contre détaille les paramètres, les schémas, les réponses d'erreur et des exemples à copier.

Essayer en 30 secondesCopier le lien du titre

curl -X POST http://localhost:8787/v1/payments \
  -H "authorization: Bearer $PONT_API_KEY" \
  -H "content-type: application/json" \
  -d '{"amount":5000,"currency":"XOF","country":"BJ","customer":{"phone":"+2290100000001"},"reference":"commande-42"}'

Résultat attendu : 201 et un paiement pending avec nextAction.type = "await_customer".

Règles communesCopier le lien du titre

• Montants entiers : le XOF et le XAF n'ont pas de décimales.
• Idempotence : en-tête Idempotency-Key (8 à 255 caractères), sinon auto:<type>:<reference>. Même clé avec un contenu différent : 409 idempotency_conflict.
• Erreurs : { "error": { "code", "message", "fix"? } }. Voir les codes d'erreur.
• Paiement ambigu : le statut ne change pas, needsReconciliation passe à true. Voir les statuts.

La spécification brute est disponible : openapi.json.

PagesCopier le lien du titre