POST

Créer une demande de paiement

Envoie une notification à un utilisateur CaurisPay pour lui demander un paiement. Le payeur confirme depuis son application avec son code PIN.

Paramètres

amountstringMontant demandé, ex : "5000.00"

currencystringXOF, EUR, GHS, GNF, KES, NGN, USD ou ZAR

payerPhonestringNuméro du payeur, format international

callbackUrlstringURL HTTPS qui recevra le webhook

Réponse

À la création, la demande passe en statut pending puis notified dès que la notification est envoyée au payeur.

Codes d'erreur

PAYER_NOT_ELIGIBLE400Numéro non lié à un compte CaurisPay

CANNOT_PAY_YOURSELF400Le numéro correspond à votre propre compte

URL_MUST_BE_HTTPS400callbackUrl doit être en HTTPS

POST /v1/payment-requests

curl -X POST \
  https://api.caurispay.com/v1/payment-requests \
  -H "X-Api-Key: pk_..." \
  -H "X-Api-Secret: sk_..." \
  -d '{
    "amount": "5000.00",
    "currency": "XOF",
    "payerPhone": "+22890123456",
    "callbackUrl": "https://votresite.com/webhooks/caurispay"
  }'

Réponse

{
  "success": true,
  "message": "Demande de paiement créée et envoyée au payeur.",
  "status": "notified",
  "token": "PAY-A1B2C3D4"
}