Module Facturation

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/invoices pour é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, toute demande de facture répond 403 BILLING_MODULE_NOT_ENABLED. Le refus est explicite et non silencieux, 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.nc" }
    }
  }'

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.

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.

La signature en ligne est sans valeur eIDAS. Elle vaut preuve d'accord commercial, comme un « bon pour accord » manuscrit : horodatage, nom du signataire et adresse IP. Ce n'est pas une signature électronique qualifiée au sens du règlement (UE) 910/2014.

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.