Pay : factures

Créer une facture

POST/v1/invoices

Prix en USDT ou dans une devise d’affichage ouverte (voir GET /v1/rates) ; le cours est figé à la création. Une adresse de dépôt par chaîne offerte (variante A), ou l’adresse partagée du marchand avec un montant unique (variante B, une seule chaîne). Erreurs : chain_not_available, amount_below_minimum, amount_above_cap, ttl_out_of_range, duplicate_external_ref, unique_amount_exhausted (409, variante B), currency_suspended (409, garde USDT/USD ou cours manquant), kyb_required (403, mode live).

Authentification: Clé d’API (Authorization: Bearer)
Portée requise: pay:write

Rejouable sans risque avec l’en-tête Idempotency-Key : voir Idempotence.

En-têtes#

Idempotency-Keystringobligatoire
Obligatoire sur tous les POST Pay ; rend la requête rejouable sans risque pendant 24 heures. Cloisonné par environnement de la clé.

de 1 à 255 caractères

Corps de la requête#

currencystringobligatoire
USDT, ou une devise d’affichage ouverte (USD, EUR, XOF…).
price_e6stringobligatoire
Prix en millionièmes de la devise, par exemple 12500000 = 12,50. Pas plus de décimales que la devise n’en a (XOF : aucune).
chain_idstableau de integerobligatoire
Chaînes proposées au payeur.

de 1 à 10 éléments
variantstring
A : une adresse de dépôt par facture. B : adresse partagée et montant unique, une seule chaîne.

Valeurs A B
Par défaut "A"
ttl_secondsinteger
Validité ; 3600 par défaut, de 900 à 604800.
external_refstring
Votre référence, unique par environnement.

au plus 200 caractères
descriptionstring
au plus 1000 caractères
metadataobject
8 Kio au plus.

Réponses#

201Facture créée.

En-têtes de réponse

Locationstring
/v1/invoices/{id}.

Champs de l’objet

idstring · uuid
objectstring
Valeurs invoice
statusstring
Valeurs waiting confirming paid underpaid overpaid expired paid_late canceled held
environmentstring
Valeurs test live
external_refstringpeut valoir null
variantstring
Valeurs A B
chain_idintegerpeut valoir null
Chaîne du paiement (fixée à la création quand une seule chaîne est offerte).
tokenstringpeut valoir null
decimalsintegerpeut valoir null
amount_dueany
amount_receivedany
amount_pendingany
differencestringpeut valoir null
Écart signé au montant dû, en unités natives.
priceobjectpeut valoir null
Champs de l’objet
- currencystring
- price_e6string
- fx_rate_e6string
  Unités de la devise pour 1 USDT, en millionièmes, figé à la création.
- fx_sourcestring
- fx_as_ofstring · date-time
chainstableau de object
Champs de chaque élément
- amountstring
  Unités natives, par exemple 12500000 pour 12,5 USDT à 6 décimales.
- amount_formattedstring
- decimalsinteger
- chain_idinteger
- tokenstring
- deposit_addressstring
  Base58 T… sur TRON.
- payment_uristringpeut valoir null
  URI EIP-681 pour un QR code (chaînes EVM).
expires_atstring · date-time
paid_atstring · date-timepeut valoir null
created_atstring · date-time
metadataobject

4xx · 5xxErreur.

Erreur au format standard : voir Erreurs.

Requête

cURL

curl -X POST "https://aicscan.io/v1/invoices" \
  -H "Authorization: Bearer $AICSCAN_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "currency": "string",
    "price_e6": "string",
    "chain_ids": [
      0
    ],
    "variant": "A",
    "ttl_seconds": 0,
    "external_ref": "string",
    "description": "string",
    "metadata": {}
  }'

JavaScript

const res = await fetch('https://aicscan.io/v1/invoices', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.AICSCAN_API_KEY}`,
    'Content-Type': 'application/json',
    'Idempotency-Key': crypto.randomUUID(),
  },
  body: JSON.stringify({
    "currency": "string",
    "price_e6": "string",
    "chain_ids": [
      0
    ],
    "variant": "A",
    "ttl_seconds": 0,
    "external_ref": "string",
    "description": "string",
    "metadata": {}
  }),
});
const data = await res.json();
if (!res.ok) throw new Error(data.error.code);
console.log(data);

Python

import os, uuid
import requests

resp = requests.post(
    "https://aicscan.io/v1/invoices",
    headers={
        "Authorization": f"Bearer {os.environ['AICSCAN_API_KEY']}",
        "Idempotency-Key": str(uuid.uuid4()),
    },
    json={
        "currency": "string",
        "price_e6": "string",
        "chain_ids": [
            0
        ],
        "variant": "A",
        "ttl_seconds": 0,
        "external_ref": "string",
        "description": "string",
        "metadata": {}
    },
    timeout=10,
)
resp.raise_for_status()
print(resp.json())

Réponse 201

JSON

{
  "id": "0193a1c9-41aa-7b2e-9c0d-1e2f3a4b5c6d",
  "object": "invoice",
  "status": "waiting",
  "environment": "test",
  "external_ref": "string",
  "variant": "A",
  "chain_id": 56,
  "token": "string",
  "decimals": 0,
  "amount_due": null,
  "amount_received": null,
  "amount_pending": null,
  "difference": "string",
  "price": {
    "currency": "string",
    "price_e6": "string",
    "fx_rate_e6": "string",
    "fx_source": "string",
    "fx_as_of": "2026-11-14T09:30:13Z"
  },
  "chains": [
    {
      "amount": "string",
      "amount_formatted": "string",
      "decimals": 0,
      "chain_id": 56,
      "token": "string",
      "deposit_address": "string",
      "payment_uri": "string"
    }
  ],
  "expires_at": "2026-11-14T09:30:13Z",
  "paid_at": "2026-11-14T09:30:13Z",
  "created_at": "2026-11-14T09:30:13Z",
  "metadata": {}
}