GET
/
v1
/
invoices
Lister les factures
curl --request GET \
  --url https://api.pay.izichange.com/v1/invoices \
  --header 'Authorization: Bearer <token>'
[
  {
    "id": "<string>",
    "customerEmail": "<string>",
    "customerName": "<string>",
    "amount": "<string>",
    "currency": "<string>",
    "assetCode": {},
    "description": {},
    "meta": {},
    "status": "<string>",
    "paymentIntentId": {},
    "expiresAt": {},
    "createdAt": "<string>",
    "paymentLink": "<string>"
  }
]

Autorisations

Authorization
string
header
requis

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Paramètres de requête

cursor
string

Identifiant de la dernière facture de la page précédente.

take
number

Nombre d'éléments à retourner (défaut 20, max 100).

status
string

Filtre par statut.

merchantReference
string

Filtre par référence marchand (recherche insensible à la casse, sous-chaîne autorisée).

Réponse

200 - application/json

Liste paginée des factures.

id
string
requis

Identifiant unique de la facture.

customerEmail
string
requis

Email du client destinataire.

customerName
string
requis

Nom du client destinataire.

amount
string
requis

Montant facturé — chaîne décimale (preserve la précision).

currency
string
requis

Code de la devise (fiat ou crypto).

assetCode
object
requis

Code de l'actif crypto suggéré pour le paiement (optionnel).

description
object
requis

Description libre affichée au client (optionnelle).

meta
object
requis

Métadonnées libres attachées à la facture, dont la liste des articles lorsqu'elle est détaillée.

status
string
requis

Statut courant de la facture (draft, sent, paid, expired, cancelled).

paymentIntentId
object
requis

Identifiant de l'intention de paiement liée si la facture a été payée.

expiresAt
object
requis

Date d'expiration — ISO 8601. null si pas d'échéance.

createdAt
string
requis

Date de création — ISO 8601.

Lien public que le client peut utiliser pour payer la facture.