Invoices

Les opérations de facture sont actuellement exposées principalement à travers les routes de billing à portée marchande.

Objet Invoice

{
  "id": "inv_abc123",
  "object": "invoice",
  "customer": "cus_xyz789",
  "status": "open",
  "currency": "xof",
  "amount_due": 175000,
  "amount_paid": 0,
  "due_date": "2026-03-15",
  "hosted_invoice_url": "https://invoice.ikawaari.com/inv_abc123",
  "created": 1708300800
}

Famille de routes implémentée

Les routes marchandes de facture actuelles incluent :

• GET /api/v1/merchant/invoices
• GET /api/v1/merchant/invoices/{id}
• POST /api/v1/merchant/invoices
• PATCH /api/v1/merchant/invoices/{id}/status
• POST /api/v1/merchant/billing/wallet/invoices/{invoiceId}/apply

Des chemins marchands compatibles hérités peuvent aussi être disponibles sous api/merchant/*.

Lister les factures

GET /api/v1/merchant/invoices

Paramètre	Type	Description
page	integer	Numéro de page
limit	integer	Nombre de résultats par page
status	string	Filtrer par statut de facture

Créer une facture

POST /api/v1/merchant/invoices

Mettre à jour le statut d’une facture

PATCH /api/v1/merchant/invoices/{id}/status

Appliquer le wallet client à une facture

POST /api/v1/merchant/billing/wallet/invoices/{invoiceId}/apply

Note d’intégration

La documentation actuelle doit traiter les factures comme faisant partie de la surface de billing marchand, sauf si un contrôleur public de facture distinct est explicitement exposé.