Pay : factures

Lister les factures

GET/v1/invoices

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

Liste paginée par curseur : voir Pagination.

Paramètres de requête#

statusstring
Valeurs waiting confirming paid underpaid overpaid expired paid_late canceled held
chain_idinteger · int64
Identifiant de chaîne : 56 BNB Chain, 1 Ethereum, 8453 Base, 42161 Arbitrum One, 137 Polygon, 728126428 TRON.
external_refstring
created_afterstring
Date ou date et heure ISO 8601, incluse.
created_beforestring
Date ou date-heure ISO 8601, exclue.
limitinteger
Par défaut 50
de 1 à 100
cursorstring
next_cursor de la page précédente, tel quel.

Réponses#

200Une page de factures.

Champs de l’objet

datatableau de objectobligatoire
Champs de chaque élément
- 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
has_morebooleanobligatoire
next_cursorstringobligatoirepeut valoir null

4xx · 5xxErreur.

Erreur au format standard : voir Erreurs.

Requête

cURL

curl "https://aicscan.io/v1/invoices?chain_id=56&limit=20" \
  -H "Authorization: Bearer $AICSCAN_API_KEY"

JavaScript

const res = await fetch('https://aicscan.io/v1/invoices?chain_id=56&limit=20', {
  headers: {
    Authorization: `Bearer ${process.env.AICSCAN_API_KEY}`,
  },
});
const data = await res.json();
if (!res.ok) throw new Error(data.error.code);
console.log(data);

Python

import os
import requests

resp = requests.get(
    "https://aicscan.io/v1/invoices?chain_id=56&limit=20",
    headers={
        "Authorization": f"Bearer {os.environ['AICSCAN_API_KEY']}",
    },
    timeout=10,
)
resp.raise_for_status()
print(resp.json())

Réponse 200

JSON

{
  "data": [
    {
      "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": {}
    }
  ],
  "has_more": true,
  "next_cursor": "0193a1b25c3d7e4f8a9b0c1d2e3f4a5b"
}