Demarrer

Quickstart

Creez votre premier paiement sandbox en cinq minutes, sans quitter votre terminal.

1. Recuperez votre cle sandbox

Vos cles sont generees automatiquement a l’inscription. Retrouvez-les dans Developers → API Keys. Utilisez la cle secrete sk_test_… cote serveur uniquement.

2. Creez un paiement

Les montants sont des entiers exprimes dans la plus petite unite de la devise. Le franc CFA n’ayant pas de decimale, 10000 represente 10 000 XOF.

curl http://localhost:3000/api/v1/payments \
  -X POST \
  -H "Authorization: Bearer sk_test_xxx" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-12345" \
  -d '{
    "amount": 10000,
    "currency": "XOF",
    "country": "TG",
    "payment_method": "mobile_money",
    "network": "tmoney",
    "customer": { "phone": "+22890000000" },
    "reference": "ORDER-12345"
  }'

Que se passe-t-il ?

WanePay valide la requete, selectionne une connexion capable de traiter du mobile money au Togo en XOF, cree une tentative et renvoie un paiement au statut pending avec l’action attendue du client.

3. Suivez le statut

Interrogez le paiement, ou — recommande — abonnez-vous aux webhooks pour etre notifie sans polling.

curl http://localhost:3000/api/v1/payments/pay_8f2k39dmz0qw \
  -H "Authorization: Bearer sk_test_xxx"

En sandbox, un numero finissant par 0000 aboutit a succeeded apres quelques secondes.
Un numero finissant par 0001 echoue avec insufficient_funds.
Vous pouvez aussi forcer l’issue via POST /v1/sandbox/simulate ou depuis le dashboard.

4. Encaissez sans code (optionnel)

Si vous n’avez pas encore de backend, creez un payment link depuis le dashboard et partagez son URL : le checkout WanePay collecte le moyen de paiement et confirme la transaction.

Documentation des payment links

5. Passez en production

La production requiert la verification de votre entreprise et la disponibilite d’une connexion reelle autorisee sur votre marche. Tant que ce n’est pas le cas, seules les connexions sandbox simulees sont utilisables.