Comercios

Registrar un comercio

string

requerido

Nombre visible del negocio, por ejemplo "Acme Digital Goods".

POST /merchants
Authorization: Bearer <console_jwt>   # solo consola

// 201 Created
{
  "merchantId": "mch_c8fdac10d39c0c4d",
  "apiKey": "sk_mch_3dc34f4326fa081f02b1e552a91b4696bb541572cbe89b23"
}

apiKey se muestra exactamente una vez. Solo se guarda su hash SHA-256.

Consultar mi saldo

GET /merchant/me
Authorization: Bearer sk_mch_...

// 200 OK
{
  "merchant": {
    "id": "mch_c8fdac10d39c0c4d",
    "name": "Acme Digital Goods",
    "balanceMinor": 200,
    "currency": "USD",
    "payoutAddress": null
  }
}

balanceMinor va en centavos de USD. Sube cada vez que se paga uno de tus cargos.

Configurar la dirección de payout

A dónde va el dinero liquidado. La dirección se filtra automáticamente (KYT); las bloqueadas se rechazan con 403.

PUT /merchant/payout-address
Authorization: Bearer sk_mch_...
Content-Type: application/json

{ "address": "0xTuDireccionDeBilletera..." }

// 200 OK
{ "ok": true, "kyt": { "verdict": "pass", "reason": "no_blocklist_hit" } }

Errores:

Estado	Significado
`400`	No es una dirección EVM válida (`/^0x[a-fA-F0-9]{40}$/`).
`403`	Dirección marcada por el filtro KYT; incluye el `verdict`.

Listar mis cargos

Los últimos 100 cargos, del más reciente al más antiguo.

GET /merchant/charges
Authorization: Bearer sk_mch_...

{ "charges": [ { "chargeId": "...", "...": "..." } ] }

Mira el objeto cargo para el detalle de cada campo.

Filtrar una dirección (consola)

Filtrado KYT independiente; útil antes de pagar a una dirección arbitraria.

POST /kyt/screen
Authorization: Bearer <console_jwt>
Content-Type: application/json

{ "address": "0x...", "chain": "base" }

{ "verdict": "pass", "reason": "no_blocklist_hit" }

Exportar transacciones (consola)

Exportación contable directa desde la cadena de auditoría; cada fila lleva su número de secuencia y el hash del evento.

GET /export/transactions.csv?from=2026-08-01&to=2026-08-31
Authorization: Bearer <console_jwt>

Si no das rango, toma los últimos 30 días. La respuesta es text/csv.

​Comercios

​Registrar un comercio

​Consultar mi saldo

​Configurar la dirección de payout

​Listar mis cargos

​Filtrar una dirección (consola)

​Exportar transacciones (consola)

Comercios

Registrar un comercio

Consultar mi saldo

Configurar la dirección de payout

Listar mis cargos

Filtrar una dirección (consola)

Exportar transacciones (consola)