{
  "link_id": "d52e7b91-4c68-4f89-1b23-5d7e9f0a2c46",
  "account_id": "ae8c1f02-3b45-4c67-9d12-8f0e5a6b7c8d",
  "chain": "eth",
  "address": "0x71C7656EC7ab88b098defB751B7401B5f6d8976F",
  "proof_id": "c41d2a88-7f3e-4b21-9c6d-2e8f1a5b7d90"
}

Wallet externa vinculada

Se vinculo una wallet externa (custody=client) a la cuenta resolviendo un desafio nonce (POST /v1/wallet-links/challenges + POST /v1/wallet-links/verify). La wallet sigue bajo custodia del cliente; el vinculo solo prueba la titularidad de la direccion.

Cada entrega incluye X-Webhook-Event, X-Webhook-Event-ID, X-Webhook-Delivery-ID, X-Webhook-Timestamp y X-Webhook-Signature = hex(HMAC-SHA256(secret, timestamp + "." + body)). Responde 2xx; hasta 5 intentos con backoff incremental.

WEBHOOK

wallet_linked

{
  "link_id": "d52e7b91-4c68-4f89-1b23-5d7e9f0a2c46",
  "account_id": "ae8c1f02-3b45-4c67-9d12-8f0e5a6b7c8d",
  "chain": "eth",
  "address": "0x71C7656EC7ab88b098defB751B7401B5f6d8976F",
  "proof_id": "c41d2a88-7f3e-4b21-9c6d-2e8f1a5b7d90"
}

Autorizaciones

Authorization

string

header

requerido

JWT de sesión (de register/login) o llave de API (pk_...). X-API-Key: <token> se acepta como header alternativo.

Cuerpo

application/json

link_id

string

account_id

string

chain

enum<string>

Opciones disponibles:

eth,

tron

address

string

proof_id

string

Prueba de firma que respalda el vinculo.

Respuesta

200

Devuelve cualquier 2xx para confirmar la entrega.