Tu comercio

Endpoints para administrar tu cuenta: claves de API, apariencia del checkout y métricas. Todos usan tu clave secreta (Authorization: Bearer sk_…).

Claves de API

Listar


GET /v1/api-keys


[
  {
    "id": "key_...",
    "type": "publishable",
    "mode": "live",
    "prefix": "pk_live",
    "lastFour": "a1b2",
    "name": "Clave del sitio web",
    "status": "active",
    "lastUsedAt": "2026-06-09T17:00:00.000Z",
    "createdAt": "2026-05-01T10:00:00.000Z"
  }
]

Crear


POST /v1/api-keys

Campo	Tipo	Descripción
`type`	string	`publishable` o `secret`.
`mode`	string	`test` o `live`.
`name`	string	Nombre para identificarla (opcional).

La respuesta incluye key con el valor completo, mostrado una sola vez:


{
  "id": "key_...",
  "type": "secret",
  "mode": "live",
  "prefix": "sk_live",
  "lastFour": "9f7c",
  "name": "Servidor de producción",
  "status": "active",
  "key": "sk_live_9c1f...completa...9f7c"
}

Guarda la key en ese momento. No se puede volver a recuperar; si la pierdes, revócala y genera otra.

Revocar


DELETE /v1/api-keys/{id}

La clave queda revoked y deja de funcionar de inmediato.

Apariencia del checkout

Configura los colores, la tipografía, el logo y los dominios autorizados a incrustar tu checkout.

Consultar


GET /v1/merchant/config


{
  "themeTokens": {
    "colorPrimary": "#4f46e5",
    "colorBackground": "#ffffff",
    "colorText": "#111827",
    "radius": "12px",
    "fontFamily": "system-ui, sans-serif"
  },
  "logoUrl": null,
  "layoutTemplate": "classic",
  "allowedOrigins": ["https://mitienda.com"],
  "statementDescriptor": "MITIENDA",
  "supportEmail": "soporte@mitienda.com"
}

Actualizar


PATCH /v1/merchant/config

Campo	Descripción
`themeTokens`	Colores (hex), `radius`, `fontFamily` (de una lista permitida).
`layoutTemplate`	`classic` · `compact` · `minimal`.
`logoUrl`	URL absoluta del logo.
`allowedOrigins`	Dominios autorizados a incrustar tu checkout (CORS + frame-ancestors por comercio).
`statementDescriptor`	Texto en el estado de cuenta (máx. 22).
`supportEmail`	Correo de soporte mostrado al comprador.

Por seguridad, Seif solo acepta este conjunto cerrado de tokens de diseño — nunca CSS/HTML/JS arbitrario. Esto protege los campos de tarjeta de ataques de superposición (clickjacking).

Métricas


GET /v1/analytics/summary

Resumen de los últimos 14 días:


{
  "approvalRate": 0.82,
  "totalVolumeCents": 4500000,
  "transactionCount": 120,
  "avgTicketCents": 45750,
  "currency": "VES",
  "series": [{ "date": "2026-06-01", "amountCents": 320000, "count": 8 }],
  "topDeclineReasons": [{ "code": "0051", "label": "Fondos insuficientes", "count": 6 }]
}

Campo	Descripción
`approvalRate`	Proporción de aprobación (0–1).
`totalVolumeCents`	Volumen aprobado (unidades menores).
`avgTicketCents`	Ticket promedio.
`series`	Serie diaria de volumen y conteo.
`topDeclineReasons`	Principales motivos de rechazo.