Pay : factures

Annuler une facture en attente

POST/v1/invoices/{id}/cancel

Seule une facture waiting sans paiement compté peut être annulée (409 invoice_not_cancelable). Un paiement reçu ensuite est traité comme paid_late.

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

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

Paramètres de chemin#

idstring · uuidobligatoire

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

Réponses#

200Facture annulée.

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/0193a1d0-1a2b-7c3d-8e4f-5a6b7c8d9e0f/cancel" \
  -H "Authorization: Bearer $AICSCAN_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"

JavaScript

const res = await fetch('https://aicscan.io/v1/invoices/0193a1d0-1a2b-7c3d-8e4f-5a6b7c8d9e0f/cancel', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.AICSCAN_API_KEY}`,
    'Idempotency-Key': crypto.randomUUID(),
  },
});
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/0193a1d0-1a2b-7c3d-8e4f-5a6b7c8d9e0f/cancel",
    headers={
        "Authorization": f"Bearer {os.environ['AICSCAN_API_KEY']}",
        "Idempotency-Key": str(uuid.uuid4()),
    },
    timeout=10,
)
resp.raise_for_status()
print(resp.json())

Réponse 200

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