Pay : marchand

Profil du marchand, KYB, chaînes et adresses de versement

GET/v1/merchant

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

Réponses#

200Marchand dans l’environnement de la clé.

Champs de l’objet

idstring · uuid
objectstring
Valeurs merchant
environmentstring
Valeurs test live
onchain_merchant_idstring
Identifiant bytes32 du marchand dans AicscanPayRegistry.
kybobject
Champs de l’objet
- statusstring
  Valeurs none pending approved rejected expired
- riskstringpeut valoir null
  Valeurs low medium high null
- checked_atstring · date-timepeut valoir null
live_enabledboolean
frozenboolean
feeobject
Champs de l’objet
- fee_bpsinteger
- min_fee_usdt_e6string
underpay_tolerance_bpsintegerpeut valoir null
chainstableau de object
Champs de chaque élément
- chain_idinteger
- namestring
- registrystring
- factorystring
- usdt_tokenstring
- usdt_decimalsinteger
- registeredboolean
- activeboolean
- ownerstringpeut valoir null
- payout_addressstringpeut valoir null
- pending_payoutobject
  Champs de l’objet
  - addressstringpeut valoir null
  - requested_atstring · date-timepeut valoir null
- pending_ownerobject
  Champs de l’objet
  - addressstringpeut valoir null
  - requested_atstring · date-timepeut valoir null
- frozen_untilstring · date-timepeut valoir null
created_atstring · date-time

4xx · 5xxErreur.

Erreur au format standard : voir Erreurs.

Requête

cURL

curl "https://aicscan.io/v1/merchant" \
  -H "Authorization: Bearer $AICSCAN_API_KEY"

JavaScript

const res = await fetch('https://aicscan.io/v1/merchant', {
  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/merchant",
    headers={
        "Authorization": f"Bearer {os.environ['AICSCAN_API_KEY']}",
    },
    timeout=10,
)
resp.raise_for_status()
print(resp.json())

Réponse 200

JSON

{
  "id": "0193a1c9-41aa-7b2e-9c0d-1e2f3a4b5c6d",
  "object": "merchant",
  "environment": "test",
  "onchain_merchant_id": "string",
  "kyb": {
    "status": "none",
    "risk": "low",
    "checked_at": "2026-11-14T09:30:13Z"
  },
  "live_enabled": false,
  "frozen": false,
  "fee": {
    "fee_bps": 0,
    "min_fee_usdt_e6": "string"
  },
  "underpay_tolerance_bps": 0,
  "chains": [
    {
      "chain_id": 56,
      "name": "string",
      "registry": "string",
      "factory": "string",
      "usdt_token": "string",
      "usdt_decimals": 0,
      "registered": false,
      "active": false,
      "owner": "string",
      "payout_address": "string",
      "pending_payout": {
        "address": "string",
        "requested_at": "2026-11-14T09:30:13Z"
      },
      "pending_owner": {
        "address": "string",
        "requested_at": "2026-11-14T09:30:13Z"
      },
      "frozen_until": "2026-11-14T09:30:13Z"
    }
  ],
  "created_at": "2026-11-14T09:30:13Z"
}