Historique des changements
30 octobre 2026 — sources SDK Billing 1.3.0
Référence du contrat fournisseur vérifié :48a7107.
Preview de relance en lecture seule (clé déjà enregistrée, TEST sans envoi),
cycle de vie canonique, grâce payée, ancre UTC et subscription.cancelled ;
idempotence persistante des six créations, pagination take/cursor et conservation
des interfaces existantes. Les rejeux de lien réglé/annulé peuvent renvoyer null.
Guide bilingue. Version source : la disponibilité npm reste
à vérifier et les publications registre sont bloquées par les accès manquants.
30 octobre 2026 — SDK Billing 1.2.0
Clients sans téléphone, références externes, quatre fréquences, essais et périodes, lecture canonique, import et factures dans les trois SDK. Charges utiles webhook typées et pagination préservée. Guide Billing français/anglais, avec ACTIVE ≠ paid, cycle webhook et parcours TEST. Python/PHP restent installables par source ; publication de registre conditionnée aux accès disponibles.Octobre 2026
Inscription ouverte, sans abonnement (17 octobre)
- L’inscription est ouverte à tous, sans invitation. Le compte démarre dans la sandbox gratuite.
- Plus d’abonnement SahelPay : le passage en live dépend uniquement du KYC approuvé et de l’accès production. SahelPay facture une commission de service par transaction réussie.
- Les paiements portent désormais
settlement_mode(platform: fonds encaissés via SahelPay ;direct: fonds arrivés sur votre propre compte marchand), y compris dans les webhooks (funds_held_by_sahelpay,commission_collection). Un paiementdirectn’est pas remboursable via SahelPay.
SDKs 1.1.0 (17 octobre)
- Corrigé :
payments.create()envoiedescriptionau niveau racine. Les versions 1.0.0 JavaScript et Python la plaçaient dansmetadata, où l’API l’écrasait : la description n’apparaissait ni dans le dashboard ni dans les webhooks. - Corrigé :
paymentLinks.create()avec un montant (priceoufixed_amount) crée un lien à prix fixe (amount_mode: FIXED). En 1.0.0 les trois SDKs créaient un lien à montant libre (OPEN) : vérifiez les liens créés par SDK. - Corrigé (Python) :
payments.search()etpayments.recommend()encodent leurs paramètres (le+d’un numéro était lu comme un espace).PaymentLinkaccepte un lien à montant libre (price: null). - Changé : la vérification de signature n’accepte plus qu’
X-SahelPay-Signature: t=...,v1=.... L’ancien repli (HMAC du corps seul, sans horodatage) est retiré : SahelPay ne l’émet pas et il n’offrait aucune protection contre le rejeu. - Changé :
customer_phoneest facultatif avec le checkout hébergé (la page le demande au payeur).callback_urlest ignoré (avertissement en Python) : les webhooks partent vers les endpoints de l’application. - Ajouté :
payments.expire(),paymentLinks.update()/delete()/retrieveById(), livraisons webhook (listLogs,retrieveLog,retry,stats,listEvents,retrieveEvent), paiement sécurisé (secureOrders.*), typesrefund.pendingetpayment.cancelled,idsur l’événement webhook Python. - Le SDK JavaScript
@sahelpay/sdk1.1.0 est publié sur npm. PHP et Python : installation depuis le dépôt en attendant Packagist et PyPI.
Isolation test / live et webhooks fiables
- Une clé ne lit que les objets de son mode : une clé
sk_test_...ne voit pas les paiements live, et inversement. Même règle pour les remboursements, liens, abonnements et le portail client. - Endpoints webhook par application, avec un mode (
test,liveou les deux) : un événement de test ne part plus vers un endpoint live. - Les webhooks de paiement sont écrits dans la même transaction que le changement de statut, puis relayés : aucun événement perdu. Un même événement garde le même
idd’une relance à l’autre : dédupliquez dessus. refund.pendingest émis à chaque demande de remboursement.client_referenceest renvoyé parGET /v1/payments/{id}/status,/detailset/search.- Le checkout hébergé demande le numéro Orange Money du payeur avant le transfert s’il n’a pas été fourni. Les paiements par transfert ajoutent à
data.metadatadu webhookamount_to_pay,amount_received,surplusetmanual_merchant_confirmation.
Un seul moyen de paiement
- Le mobile money au Mali est le seul moyen de paiement ; les autres fournisseurs ont été retirés.
- Toute autre valeur de
provider/payment_methodest rejetée avec400, jamais routée ailleurs. GET /v1/payments/providersetGET /v1/payments/recommendne renvoient plus que le moyen de paiement disponible.
Production sur demande, sandbox gratuite
- La sandbox est gratuite et ouverte à tous les comptes.
- L’accès production est soumis à une validation et à un contrat distinct précisant son périmètre et les rôles de chaque partie (
401 PRODUCTION_KEY_DISABLEDou403 PAID_SUBSCRIPTION_REQUIREDsinon). Voir Passer en production. - L’ouverture de compte se fait sur demande à support@sahelpay.africa.
Paiements
X-Idempotency-Keyest obligatoire surPOST /v1/payments. Rejouer la même clé renvoie le même paiement ; une demande différente sous la même clé renvoie409.- Le checkout hébergé reprend la même session de paiement après un rechargement ou un double clic.
- Après un paiement confirmé, la page de paiement redirige automatiquement le client vers votre
return_url(HTTPS, hors domaines SahelPay). Aucune redirection automatique pour un paiement en attente ou échoué. - Option de test explicite :
metadata.sahelpay_mock(simulateur, option SDKmock) est distincte demetadata.sandbox(sandbox de l’opérateur). Les deux sont refusées en production. payment.expiredest émis à toute expiration (délai écoulé,POST /v1/payments/{id}/expire, réconciliation). Un paiement n’a pas de statut « annulé » : un abandon finit enpayment.expired.
Fonctions retirées ou restreintes
- OPR (
/v1/opr/*) : limité à la sandbox.
Nouveautés
- Programme Partenaires SPAY : SahelPay vendeur de référence, catalogue de produits à prix validé,
items[]surPOST /v1/payments, redevance mensuelle.