Changelog

Historique des évolutions de l'API et des bibliothèques officielles.

---

Collect 2026-06

Date : juin 2026 · Statut : contrat actuel

L'API Collect est livrée sous le contrat 2026-06 : paiements direct (push Mobile Money) et hosted (checkout), webhooks signés, scopes API et rate limiting.

Nouveautés

• POST /collect/payments — création unifiée (direct ou hosted)
• Montants en unités majeures (3000 = 3 000 XOF)
• Statuts en minuscules (completed, awaiting_otp, …)
• Webhooks collect.payment.* avec signature HMAC hex sur le body brut
• Scopes collect:read, collect:write, collect:refund
• Hosted : checkout_url, sandbox POST .../pay
• OpenAPI : cdn.fluxxpay.me/v2/collect/openapi.json

Documentation & outils

• Référence API Collect
• Playground · SDKs
• Mode test

---

Correspondance API Collect

Si votre intégration a été initiée sur une version antérieure du contrat Collect, utilisez ce tableau pour adapter vos appels au contrat 2026-06.

Endpoints

Avant 2026-06	Contrat actuel
GET /collect/operators/	GET /collect/payments/operators/
POST /collect/mobile-money/	POST /collect/payments
POST /collect/mobile-money/confirm/	POST /collect/payments/{ref}/confirm
GET /collect/mobile-money/{ref}/	GET /collect/payments/{ref}

Champs & montants

Avant 2026-06	Contrat actuel
amount en centimes (10000 = 100 FCFA)	amount en unités majeures (3000 = 3 000 FCFA)
phone à la racine	customer.phone
Pas de mode hosted	mode: "direct" | "hosted"

Statuts

Avant 2026-06 (majuscules)	Contrat actuel (minuscules)
PENDING	pending
PROCESSING	processing
AWAITING_OTP	awaiting_otp
COMPLETED	completed
FAILED	failed
CANCELLED	cancelled

Webhooks

Avant 2026-06	Contrat actuel
collect.completed, collect.failed, …	collect.payment.completed, collect.payment.failed, …
Signature base64 sur JSON trié	X-FluxPay-Signature: t=...,v1=<hex> sur body brut

SDK JavaScript

@fluxx/collect 1.x	@fluxx/collect 2.0
createMobileMoney()	createPayment()
confirmMobileMoney()	confirmPayment()
getMobileMoneyStatus()	getPayment()
verifyWebhookSignature(payload, …) (objet JSON)	verifyWebhookSignature(rawBody, header, …)

---

SDK @fluxx/collect 2.0

• Version npm 2.0.0, alignée sur l'API 2026-06
• Packages associés : @fluxx/collect-react 2.0, fluxx/collect PHP 2.0
• OpenAPI embarqué : identique au CDN /v2/collect/openapi.json