Module Facturation
Émettre des factures conformes, adossées à un paiement ou de façon autonome.
Deux façons de facturer
Le module s'utilise de deux manières, indépendantes l'une de l'autre.
- Adossée au paiement : vous ajoutez un objet
invoicingà votre commande, et la facture est émise automatiquement à l'encaissement. - Autonome : vous appelez directement
/billing/invoicespour établir, émettre et suivre vos factures, sans passer par un paiement Mobupay.
Le second mode ne suppose aucun encaissement Mobupay : le module se souscrit seul.
Activation
Le module est un service optionnel et payant. Tant qu'il n'est pas activé depuis votre espace marchand, aucune facture n'est émise. En revanche le paiement, lui, aboutit toujours : une vente n'est jamais refusée pour un motif de facturation. La demande est journalisée et signalée, pour que vous ne croyiez pas vos factures émises.
L'objet order avec le module actif
Activez l'interrupteur pour voir quels champs de votre commande deviennent obligatoires, et pourquoi.
Sans le module, aucun de ces champs n'est obligatoire : order.buyer reste purement descriptif.
curl -X POST https://api.mobupay.nc/api/v1/payment/checkoutSession \
-H "Authorization: Bearer sk_test_VOTRE_CLE" \
-H "Content-Type: application/json" \
-d '{
"order": {
"reference": "CMD-2026-0042",
"amount": 25000,
"currency": "XPF",
"buyer": { "email": "jean.dupont@example.com" }
}
}'Capture manuelle
En capture manuelle, la validation et l'émission ont lieu à la capture, pas à la création de session : à l'empreinte, le montant définitif et parfois l'adresse ne sont pas encore connus. Vous pouvez donc créer une empreinte avec des données incomplètes, et les compléter avant de capturer.
Remboursements
Un remboursement produit automatiquement un avoir. La facture d'origine n'est jamais modifiée : une pièce comptable émise ne se corrige que par un nouveau document. Sur un remboursement partiel, l'avoir porte une ligne unique du montant remboursé ; si vous voulez créditer des lignes précises, appelez /billing/invoices/{id}/creditNote avec vos lignes.
Encaissements hors carte et trop-perçus
Un règlement reçu hors Mobupay (virement, espèces, chèque) s'enregistre par POST /billing/invoices/{id}/manual-payments, en tout ou en partie, avec l'en-tête Idempotency-Key. Au-delà du reste dû, la facture est soldée et l'excédent est inscrit en trop-perçu : la réponse porte alors un objet overpayment.
Un trop-perçu se lit par GET /billing/overpayments et s'impute, en une ou plusieurs fois, sur une autre facture ouverte du même client et dans la même devise, par POST /billing/overpayments/{id}/apply. Un montant supérieur à ce qui reste disponible, ou au reste dû de la facture choisie, est refusé. Les webhooks overpayment.created et overpayment.applied suivent chaque étape.
Devis et signature
Les devis suivent leur propre série (DEV) et se font accepter en ligne. Un devis signé vaut bon de commande, et le document signé est archivé avec son empreinte.
L'acceptation en ligne vaut preuve d'accord commercial, comme un « bon pour accord » manuscrit : elle est horodatée et porte le nom du signataire et son adresse IP.
Archivage et réversibilité
Chaque facture émise est archivée pour la durée légale, avec l'empreinte SHA-256 du PDF exactement tel que votre client l'a reçu. Les téléchargements servent l'archive, jamais une régénération : un changement de logo ou d'arrondi produirait sinon un document différent de l'original.
GET /billing/archive/{year} exporte une année complète en format ouvert, empreintes incluses. Vous pouvez partir avec vos données et les relire sans nous.