Collectes
Créer une collecte et consulter son statut.
POST /v1/collections accepte le même format pour les opérateurs activés sur votre compte. Les montants sont des entiers en XOF : 1000 signifie 1 000 XOF.
Un chemin pour chaque opérateur autorisé
Le chemin reste identique. Votre requête indique l’opérateur activé sur votre compte.
POST /v1/collections{ "operator": "moov_tg", "amount_minor": 1000, "currency": "XOF" }POST /v1/collections
Authorization: Bearer et_live_VOTRE_CLE
Idempotency-Key: commande-12345
Content-Type: application/json
{"operator":"moov_tg","msisdn":"22890000000","amount_minor":1000,"currency":"XOF","firstname":"Ada","lastname":"Doe"}Opérateurs : mtn_bj, moov_bj, moov_tg, togocel_tg. Utilisez une nouvelle clé d’idempotence par transaction voulue ; réutilisez la même clé uniquement pour réessayer la même requête. Un corps différent avec la même clé retourne 409.
La réponse 202 contient un identifiant de transaction et le statut pending. L’accusé de réception du partenaire ne signifie pas que la collecte a réussi. GET /v1/transactions/{id}/status actualise une transaction en attente auprès de Qosic. Seul le marchand propriétaire peut la consulter. Ce endpoint est limité en débit.
Les états finaux sont succeeded et failed. En cas de réussite, les frais de collecte configurés sont déduits et le montant net crédite une seule fois le solde de l’opérateur. La réponse contient fee_bps, fee_minor, net_minor, balance_before_minor et balance_after_minor.