Créer une facture

curl --request POST \
  --url https://api.sandbox-pay.izichange.com/v1/invoices \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "customerEmail": "client@example.com",
  "customerName": "Awa Diallo",
  "amount": "30000",
  "currency": "XOF",
  "description": "Abonnement Pro — juillet 2026",
  "expiresAt": "2026-07-31T23:59:59.000Z",
  "assetCode": "USDT.TRC20",
  "meta": {
    "items": [
      {
        "name": "Abonnement Pro — juillet 2026",
        "quantity": 2,
        "unitPrice": "15000",
        "description": "Accès illimité, 5 utilisateurs"
      }
    ],
    "notes": "Paiement à réception. Merci de votre confiance."
  },
  "merchantReference": "facture-4821",
  "language": "en",
  "collectCustomerInformation": false
}
'

import requests

url = "https://api.sandbox-pay.izichange.com/v1/invoices"

payload = {
    "customerEmail": "client@example.com",
    "customerName": "Awa Diallo",
    "amount": "30000",
    "currency": "XOF",
    "description": "Abonnement Pro — juillet 2026",
    "expiresAt": "2026-07-31T23:59:59.000Z",
    "assetCode": "USDT.TRC20",
    "meta": {
        "items": [
            {
                "name": "Abonnement Pro — juillet 2026",
                "quantity": 2,
                "unitPrice": "15000",
                "description": "Accès illimité, 5 utilisateurs"
            }
        ],
        "notes": "Paiement à réception. Merci de votre confiance."
    },
    "merchantReference": "facture-4821",
    "language": "en",
    "collectCustomerInformation": False
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    customerEmail: 'client@example.com',
    customerName: 'Awa Diallo',
    amount: '30000',
    currency: 'XOF',
    description: 'Abonnement Pro — juillet 2026',
    expiresAt: '2026-07-31T23:59:59.000Z',
    assetCode: 'USDT.TRC20',
    meta: {
      items: [
        {
          name: 'Abonnement Pro — juillet 2026',
          quantity: 2,
          unitPrice: '15000',
          description: 'Accès illimité, 5 utilisateurs'
        }
      ],
      notes: 'Paiement à réception. Merci de votre confiance.'
    },
    merchantReference: 'facture-4821',
    language: 'en',
    collectCustomerInformation: false
  })
};

fetch('https://api.sandbox-pay.izichange.com/v1/invoices', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.sandbox-pay.izichange.com/v1/invoices",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'customerEmail' => 'client@example.com',
    'customerName' => 'Awa Diallo',
    'amount' => '30000',
    'currency' => 'XOF',
    'description' => 'Abonnement Pro — juillet 2026',
    'expiresAt' => '2026-07-31T23:59:59.000Z',
    'assetCode' => 'USDT.TRC20',
    'meta' => [
        'items' => [
                [
                                'name' => 'Abonnement Pro — juillet 2026',
                                'quantity' => 2,
                                'unitPrice' => '15000',
                                'description' => 'Accès illimité, 5 utilisateurs'
                ]
        ],
        'notes' => 'Paiement à réception. Merci de votre confiance.'
    ],
    'merchantReference' => 'facture-4821',
    'language' => 'en',
    'collectCustomerInformation' => false
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.sandbox-pay.izichange.com/v1/invoices"

	payload := strings.NewReader("{\n  \"customerEmail\": \"client@example.com\",\n  \"customerName\": \"Awa Diallo\",\n  \"amount\": \"30000\",\n  \"currency\": \"XOF\",\n  \"description\": \"Abonnement Pro — juillet 2026\",\n  \"expiresAt\": \"2026-07-31T23:59:59.000Z\",\n  \"assetCode\": \"USDT.TRC20\",\n  \"meta\": {\n    \"items\": [\n      {\n        \"name\": \"Abonnement Pro — juillet 2026\",\n        \"quantity\": 2,\n        \"unitPrice\": \"15000\",\n        \"description\": \"Accès illimité, 5 utilisateurs\"\n      }\n    ],\n    \"notes\": \"Paiement à réception. Merci de votre confiance.\"\n  },\n  \"merchantReference\": \"facture-4821\",\n  \"language\": \"en\",\n  \"collectCustomerInformation\": false\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.sandbox-pay.izichange.com/v1/invoices")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"customerEmail\": \"client@example.com\",\n  \"customerName\": \"Awa Diallo\",\n  \"amount\": \"30000\",\n  \"currency\": \"XOF\",\n  \"description\": \"Abonnement Pro — juillet 2026\",\n  \"expiresAt\": \"2026-07-31T23:59:59.000Z\",\n  \"assetCode\": \"USDT.TRC20\",\n  \"meta\": {\n    \"items\": [\n      {\n        \"name\": \"Abonnement Pro — juillet 2026\",\n        \"quantity\": 2,\n        \"unitPrice\": \"15000\",\n        \"description\": \"Accès illimité, 5 utilisateurs\"\n      }\n    ],\n    \"notes\": \"Paiement à réception. Merci de votre confiance.\"\n  },\n  \"merchantReference\": \"facture-4821\",\n  \"language\": \"en\",\n  \"collectCustomerInformation\": false\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.sandbox-pay.izichange.com/v1/invoices")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"customerEmail\": \"client@example.com\",\n  \"customerName\": \"Awa Diallo\",\n  \"amount\": \"30000\",\n  \"currency\": \"XOF\",\n  \"description\": \"Abonnement Pro — juillet 2026\",\n  \"expiresAt\": \"2026-07-31T23:59:59.000Z\",\n  \"assetCode\": \"USDT.TRC20\",\n  \"meta\": {\n    \"items\": [\n      {\n        \"name\": \"Abonnement Pro — juillet 2026\",\n        \"quantity\": 2,\n        \"unitPrice\": \"15000\",\n        \"description\": \"Accès illimité, 5 utilisateurs\"\n      }\n    ],\n    \"notes\": \"Paiement à réception. Merci de votre confiance.\"\n  },\n  \"merchantReference\": \"facture-4821\",\n  \"language\": \"en\",\n  \"collectCustomerInformation\": false\n}"

response = http.request(request)
puts response.read_body

{
  "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>"
  }
}

POST

invoices

Créer une facture

curl --request POST \
  --url https://api.sandbox-pay.izichange.com/v1/invoices \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "customerEmail": "client@example.com",
  "customerName": "Awa Diallo",
  "amount": "30000",
  "currency": "XOF",
  "description": "Abonnement Pro — juillet 2026",
  "expiresAt": "2026-07-31T23:59:59.000Z",
  "assetCode": "USDT.TRC20",
  "meta": {
    "items": [
      {
        "name": "Abonnement Pro — juillet 2026",
        "quantity": 2,
        "unitPrice": "15000",
        "description": "Accès illimité, 5 utilisateurs"
      }
    ],
    "notes": "Paiement à réception. Merci de votre confiance."
  },
  "merchantReference": "facture-4821",
  "language": "en",
  "collectCustomerInformation": false
}
'

import requests

url = "https://api.sandbox-pay.izichange.com/v1/invoices"

payload = {
    "customerEmail": "client@example.com",
    "customerName": "Awa Diallo",
    "amount": "30000",
    "currency": "XOF",
    "description": "Abonnement Pro — juillet 2026",
    "expiresAt": "2026-07-31T23:59:59.000Z",
    "assetCode": "USDT.TRC20",
    "meta": {
        "items": [
            {
                "name": "Abonnement Pro — juillet 2026",
                "quantity": 2,
                "unitPrice": "15000",
                "description": "Accès illimité, 5 utilisateurs"
            }
        ],
        "notes": "Paiement à réception. Merci de votre confiance."
    },
    "merchantReference": "facture-4821",
    "language": "en",
    "collectCustomerInformation": False
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    customerEmail: 'client@example.com',
    customerName: 'Awa Diallo',
    amount: '30000',
    currency: 'XOF',
    description: 'Abonnement Pro — juillet 2026',
    expiresAt: '2026-07-31T23:59:59.000Z',
    assetCode: 'USDT.TRC20',
    meta: {
      items: [
        {
          name: 'Abonnement Pro — juillet 2026',
          quantity: 2,
          unitPrice: '15000',
          description: 'Accès illimité, 5 utilisateurs'
        }
      ],
      notes: 'Paiement à réception. Merci de votre confiance.'
    },
    merchantReference: 'facture-4821',
    language: 'en',
    collectCustomerInformation: false
  })
};

fetch('https://api.sandbox-pay.izichange.com/v1/invoices', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.sandbox-pay.izichange.com/v1/invoices",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'customerEmail' => 'client@example.com',
    'customerName' => 'Awa Diallo',
    'amount' => '30000',
    'currency' => 'XOF',
    'description' => 'Abonnement Pro — juillet 2026',
    'expiresAt' => '2026-07-31T23:59:59.000Z',
    'assetCode' => 'USDT.TRC20',
    'meta' => [
        'items' => [
                [
                                'name' => 'Abonnement Pro — juillet 2026',
                                'quantity' => 2,
                                'unitPrice' => '15000',
                                'description' => 'Accès illimité, 5 utilisateurs'
                ]
        ],
        'notes' => 'Paiement à réception. Merci de votre confiance.'
    ],
    'merchantReference' => 'facture-4821',
    'language' => 'en',
    'collectCustomerInformation' => false
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.sandbox-pay.izichange.com/v1/invoices"

	payload := strings.NewReader("{\n  \"customerEmail\": \"client@example.com\",\n  \"customerName\": \"Awa Diallo\",\n  \"amount\": \"30000\",\n  \"currency\": \"XOF\",\n  \"description\": \"Abonnement Pro — juillet 2026\",\n  \"expiresAt\": \"2026-07-31T23:59:59.000Z\",\n  \"assetCode\": \"USDT.TRC20\",\n  \"meta\": {\n    \"items\": [\n      {\n        \"name\": \"Abonnement Pro — juillet 2026\",\n        \"quantity\": 2,\n        \"unitPrice\": \"15000\",\n        \"description\": \"Accès illimité, 5 utilisateurs\"\n      }\n    ],\n    \"notes\": \"Paiement à réception. Merci de votre confiance.\"\n  },\n  \"merchantReference\": \"facture-4821\",\n  \"language\": \"en\",\n  \"collectCustomerInformation\": false\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.sandbox-pay.izichange.com/v1/invoices")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"customerEmail\": \"client@example.com\",\n  \"customerName\": \"Awa Diallo\",\n  \"amount\": \"30000\",\n  \"currency\": \"XOF\",\n  \"description\": \"Abonnement Pro — juillet 2026\",\n  \"expiresAt\": \"2026-07-31T23:59:59.000Z\",\n  \"assetCode\": \"USDT.TRC20\",\n  \"meta\": {\n    \"items\": [\n      {\n        \"name\": \"Abonnement Pro — juillet 2026\",\n        \"quantity\": 2,\n        \"unitPrice\": \"15000\",\n        \"description\": \"Accès illimité, 5 utilisateurs\"\n      }\n    ],\n    \"notes\": \"Paiement à réception. Merci de votre confiance.\"\n  },\n  \"merchantReference\": \"facture-4821\",\n  \"language\": \"en\",\n  \"collectCustomerInformation\": false\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.sandbox-pay.izichange.com/v1/invoices")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"customerEmail\": \"client@example.com\",\n  \"customerName\": \"Awa Diallo\",\n  \"amount\": \"30000\",\n  \"currency\": \"XOF\",\n  \"description\": \"Abonnement Pro — juillet 2026\",\n  \"expiresAt\": \"2026-07-31T23:59:59.000Z\",\n  \"assetCode\": \"USDT.TRC20\",\n  \"meta\": {\n    \"items\": [\n      {\n        \"name\": \"Abonnement Pro — juillet 2026\",\n        \"quantity\": 2,\n        \"unitPrice\": \"15000\",\n        \"description\": \"Accès illimité, 5 utilisateurs\"\n      }\n    ],\n    \"notes\": \"Paiement à réception. Merci de votre confiance.\"\n  },\n  \"merchantReference\": \"facture-4821\",\n  \"language\": \"en\",\n  \"collectCustomerInformation\": false\n}"

response = http.request(request)
puts response.read_body

{
  "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

customerEmail

string<email>

requis

Email du client final. La facture lui est envoyée à cette adresse.

Exemple:

"client@example.com"

customerName

string

requis

Nom du client final, tel qu'il doit apparaître sur la facture.

Exemple:

"Awa Diallo"

amount

string

requis

Montant total de la facture, exprimé dans currency. Chaîne de caractères, jamais un nombre JSON : un montant passé en number est arrondi par la précision flottante. Jusqu'à 18 décimales, et strictement supérieur à zéro.

Pattern: ^(?=.*[1-9])\d{1,18}(\.\d{1,18})?$

Exemple:

"30000"

currency

string

requis

Devise fiat dans laquelle la facture est libellée. Ex : XOF, EUR, USD.

Exemple:

"XOF"

description

string

Objet de la facture, affiché au client final.

Exemple:

"Abonnement Pro — juillet 2026"

expiresAt

string<date-time>

Date d'échéance de la facture, au format ISO 8601. Passé ce délai, le client final ne peut plus la régler.

Exemple:

"2026-07-31T23:59:59.000Z"

assetCode

string

Impose la cryptomonnaie avec laquelle le client final doit régler la facture. Ex : USDT.TRC20, BTC, USDT.BEP20. Omis, le client choisit parmi les cryptomonnaies activées sur votre compte.

Exemple:

"USDT.TRC20"

Réponse

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

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 | null

requis

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

description

object | null

requis

Description libre affichée au client (optionnelle).

Introduction

Endpoints

Créer une facture

Autorisations

Corps

Réponse