POST
/
v1
/
invoices
Créer une facture
curl --request POST \
  --url https://api.pay.izichange.com/v1/invoices \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{}'
{
  "id": "<string>",
  "customerEmail": "<string>",
  "customerName": "<string>",
  "amount": "<string>",
  "currency": "<string>",
  "assetCode": {},
  "description": {},
  "meta": {},
  "status": "<string>",
  "paymentIntentId": {},
  "expiresAt": {},
  "createdAt": "<string>",
  "paymentLink": "<string>",
  "emailDelivery": {
    "sent": true,
    "error": "<string>"
  }
}

Autorisations

Authorization
string
header
requis

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

Corps

application/json

The body is of type object.

Réponse

Facture créée et email envoyé (statut d'envoi inclus dans la réponse).

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.

emailDelivery
object
requis

Statut de la tentative d'envoi du courriel à la création — indique si l'email est parti et l'éventuelle erreur SMTP.