Pay : remboursements

Préparer un remboursement

POST/v1/refunds

Renvoie le transfert de jeton que le marchand signe et envoie depuis son propre wallet ; Aicscan ne déplace jamais de fonds. to_address est l’adresse fournie par le payeur, sur la chaîne de la facture : l’adresse d’origine d’un paiement n’est jamais proposée par défaut (c’est souvent un portefeuille d’exchange). Avertissements : origin_address (l’adresse a envoyé un paiement de cette facture), exchange_address (étiquetée exchange). Le montant est plafonné au reçu moins les remboursements déjà préparés (refund_exceeds_received). La commission n’est pas remboursée.

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

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#

invoice_idstring · uuidobligatoire
to_addressstringobligatoire
Adresse de remboursement fournie par le payeur (0x…, ou T… sur TRON).
amountstringobligatoire
Unités natives du jeton de la facture.

Réponses#

201Remboursement préparé, avec la transaction à signer.

Champs de l’objet

amountstring
Unités natives, par exemple 12500000 pour 12,5 USDT à 6 décimales.
amount_formattedstring
decimalsinteger
idstring · uuid
objectstring
Valeurs refund
environmentstring
Valeurs test live
invoice_idstring · uuidpeut valoir null
chain_idinteger
tokenstringpeut valoir null
to_addressstring
statusstring
Valeurs prepared pending succeeded failed canceled
tx_hashstringpeut valoir null
warningstableau de string
Valeurs origin_address exchange_address
created_atstring · date-time
updated_atstring · date-time
exchange_labelstringpeut valoir null
noticestring
transactionobject
transfer(to, amount) ERC-20 / TRC-20 à signer depuis le wallet du marchand.
Champs de l’objet
- chain_idinteger
- tostring
  Contrat du jeton.
- valuestring
  Valeurs 0
- datastring
  Données d’appel, 0xa9059cbb….
- function_selectorstring
  TRON seulement (TronWeb triggerSmartContract).
- parameterstring
  TRON seulement : paramètres encodés ABI, en hexadécimal, sans le sélecteur.

4xx · 5xxErreur.

Erreur au format standard : voir Erreurs.

Requête

cURL

curl -X POST "https://aicscan.io/v1/refunds" \
  -H "Authorization: Bearer $AICSCAN_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "invoice_id": "0193a1c9-41aa-7b2e-9c0d-1e2f3a4b5c6d",
    "to_address": "string",
    "amount": "string"
  }'

JavaScript

const res = await fetch('https://aicscan.io/v1/refunds', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.AICSCAN_API_KEY}`,
    'Content-Type': 'application/json',
    'Idempotency-Key': crypto.randomUUID(),
  },
  body: JSON.stringify({
    "invoice_id": "0193a1c9-41aa-7b2e-9c0d-1e2f3a4b5c6d",
    "to_address": "string",
    "amount": "string"
  }),
});
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/refunds",
    headers={
        "Authorization": f"Bearer {os.environ['AICSCAN_API_KEY']}",
        "Idempotency-Key": str(uuid.uuid4()),
    },
    json={
        "invoice_id": "0193a1c9-41aa-7b2e-9c0d-1e2f3a4b5c6d",
        "to_address": "string",
        "amount": "string"
    },
    timeout=10,
)
resp.raise_for_status()
print(resp.json())

Réponse 201

JSON

{
  "amount": "string",
  "amount_formatted": "string",
  "decimals": 0,
  "id": "0193a1c9-41aa-7b2e-9c0d-1e2f3a4b5c6d",
  "object": "refund",
  "environment": "test",
  "invoice_id": "0193a1c9-41aa-7b2e-9c0d-1e2f3a4b5c6d",
  "chain_id": 56,
  "token": "string",
  "to_address": "string",
  "status": "prepared",
  "tx_hash": "string",
  "warnings": [
    "origin_address"
  ],
  "created_at": "2026-11-14T09:30:13Z",
  "updated_at": "2026-11-14T09:30:13Z",
  "exchange_label": "string",
  "notice": "string",
  "transaction": {
    "chain_id": 56,
    "to": "string",
    "value": "0",
    "data": "string",
    "function_selector": "string",
    "parameter": "string"
  }
}