Facture

Récupérer une facture

GET /v3/products/{productId}/invoices/{invoiceId} — lire l'état d'une facture.

GET /v3/products/{productId}/invoices/{invoiceId}
Authorization: Bearer <token>

Renvoie la facture invoiceId du produit productId. Utilisez cet endpoint pour suivre le passage au statut PAID ou récupérer un QR code à jour.

Paramètres

ParamètreEmplacementDescription
productIdcheminUUID du produit.
invoiceIdcheminUUID de la facture (id renvoyé à la création).

Réponse 200

{
  "id": "0f8b7a3e-6c2d-4b1a-9e8f-5d4c3b2a1f0e",
  "productId": "2f8a9d1e-1c4b-4f37-9a55-6c0a9d3f1b02",
  "partnerInvoiceReference": "INV-2025-0001",
  "status": "PAID",
  "amount": { "value": 2500, "currency": "EUR" },
  "customer": { "externalId": "CUST-987" },
  "createdAt": "2025-03-01T10:15:00.000Z",
  "paidAt": "2025-03-01T14:02:37.000Z",
  "cancelledAt": null
}

qrCode n'est présent que si la facture est OPEN (voir cycle de vie).

Erreurs

StatutCodeCause
400INVALID_REQUESTproductId ou invoiceId n'est pas un UUID.
401MISSING_PARTNER_IDIdentifiant partenaire absent.
404INVOICE_NOT_FOUNDAucune facture avec cet id pour ce produit et ce partenaire.

Un produit inexistant ou appartenant à un autre partenaire renvoie également 404 INVOICE_NOT_FOUND : l'existence du produit n'est pas vérifiée séparément.

On this page