Collectes

L'API de Collectes vous permet d'initier des demandes de paiement Mobile Money directement depuis votre plateforme.

Initier une collecte

POST

https://api.sebpay.com/api/v1/collections

Initie une demande de paiement vers le téléphone d'un client. Le client recevra un message USSD ou une notification pour valider la transaction.

Headers

X-Public-KeyRequired

string

Votre clé publique (pk_...)

X-Secret-KeyRequired

string

Votre clé secrète (sk_...)

Request Body

amountRequired

numeric

Le montant de la transaction.

currencyRequired

string

Code de la devise (ex: XOF, EUR, USD).

phoneRequired

string

Numéro de téléphone au format international sans le (+).

operatorRequired

string

Slug de l'opérateur (mtn, moov, orange, wav...)

countryRequired

string

Code ISO du pays (BJ, CI, SN...)

external_referenceRequired

string

Votre identifiant unique pour cette transaction.

callback_urlOptional

string

URL qui recevra la notification de statut final.

curl -X POST https://api.sebpay.com/api/v1/collections \
  -H "X-Public-Key: pk_live_your_key" \
  -H "X-Secret-Key: sk_live_your_secret" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 5000,
    "currency": "XOF",
    "phone": "22997000000",
    "operator": "mtn",
    "country": "BJ",
    "external_reference": "REF8822",
    "callback_url": "https://yoursite.com/webhook"
  }'

Récupérer une transaction

GET

https://api.sebpay.com/api/v1/collections/{id_or_reference}

Récupère les détails et le statut actuel d'une transaction via son identifiant SebPay ou votre référence externe.

Path Parameters

id_or_referenceRequired

string

L'identifiant de transaction SebPay ou votre external_reference.

Headers

X-Public-KeyRequired

string

Votre clé publique (pk_...)

X-Secret-KeyRequired

string

Votre clé secrète (sk_...)

curl -X GET https://api.sebpay.com/api/v1/collections/ORDER-123 \
  -H "X-Public-Key: pk_live_your_key" \
  -H "X-Secret-Key: sk_live_your_secret"

Conseil d'intégration

Utilisez toujours le paramètre callback_url pour recevoir les mises à jour en temps réel. Ne vous reposez pas uniquement sur la consultation manuelle pour confirmer les paiements.