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.

Listar mis comercios (consola)

Todos los negocios registrados en tu espacio de trabajo, del más reciente al más antiguo. Es lo que alimenta el selector de negocio en la consola.

GET /merchants
Authorization: Bearer <console_jwt>

// 200 OK
{
  "merchants": [
    {
      "id": "mch_c8fdac10d39c0c4d",
      "name": "Acme Digital Goods",
      "balance_minor": 200,
      "currency": "USD",
      "payout_address": null,
      "created_at": "2026-08-23T09:45:47.816Z",
      "paid_charges": 3
    }
  ]
}

Cada entrada trae balance_minor (centavos de USD) y paid_charges, para que la vista general se pinte sin una llamada extra por negocio. La clave sk_mch_ no se devuelve aquí: vive únicamente en el almacenamiento de quien llama.

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

​Listar mis comercios (consola)

​Consultar mi saldo

​Configurar la dirección de payout

​Listar mis cargos

​Filtrar una dirección (consola)

​Exportar transacciones (consola)

Comercios

Registrar un comercio

Listar mis comercios (consola)

Consultar mi saldo

Configurar la dirección de payout

Listar mis cargos

Filtrar una dirección (consola)

Exportar transacciones (consola)