Démarrage rapide

Encaissez votre premier paiement en quatre étapes.

1. Créez une clé API#

Dans le tableau de bord → Développeurs → Clés API, générez une clé Test. Le secret (sk_test_…) n'est affiché qu'une fois — conservez-le côté serveur, jamais dans un navigateur ou une app mobile.

2. Vérifiez l'authentification#

GET/v1/biz/pingClé API

Terminal

curl https://api-switag.pluxce.com/v1/biz/ping \
  -H "X-Api-Key: pk_test_…" \
  -H "X-Api-Secret: sk_test_…"

3. Créez une charge#

POST/v1/biz/chargesClé API

Vous recevez une seule URL — checkout_url — à présenter au client. Elle reste payable pendant 30 minutes.

Terminal

curl -X POST https://api-switag.pluxce.com/v1/biz/charges \
  -H "X-Api-Key: pk_test_…" \
  -H "X-Api-Secret: sk_test_…" \
  -H "Content-Type: application/json" \
  -d '{"amount":5000,"reference":"ORDER-123","redirect_url":"https://ma-boutique.com/merci"}'

JSON

{
  "id": "5f1c…",
  "token": "AbC123dEf456",
  "amount": 5000,
  "currency": "XOF",
  "state": "pending",
  "checkout_url": "https://pay.pluxce.com/c/AbC123dEf456",
  "expires_at": "2026-06-01T18:15:00Z"
}

Montants

Les montants sont des entiers dans la plus petite unité. Le XOF est sans décimale : amount: 5000 = 5000 FCFA.

4. Encaissez la confirmation#

Le client paie sur checkout_url. Votre serveur est notifié par le webhook charge.succeeded — voir Webhooks. C'est la source de vérité : ne vous fiez pas au seul retour navigateur.

Et ensuite ?#

Lister vos charges: GET /v1/biz/charges
Lire le détail d'une charge: GET /v1/biz/charges/{token}
Créer un abonnement: POST /v1/biz/mandates
Créer un produit facturier: POST /v1/biz/biller/products

Si vous opérez des services de type eau, électricité, TV, école ou internet, consultez aussi Facturiers pour le flux lookup et le webhook bill.paid.