▰CovalyDocs

DOCUMENTACIÓN / API REVENDEDORES / CRÉDITOS Y SALDO

● SALDO SEGUROOPERACIONES CONFIRMADAS

Créditos y saldo

Los créditos mantienen activas tus tiendas. Un crédito nunca se descuenta solo por una solicitud de API: primero confirmas la operación en Covaly.

90créditos de bienvenidaAl crear tu cuenta
10créditos por tiendaPor cada mes activo
1–12meses por extensiónEn una sola solicitud

Cómo funciona

  1. Tu cuenta tiene un saldo de créditos.
  2. Solicitas crear una tienda o agregar meses mediante la API.
  3. Covaly crea una solicitud pendiente; en este momento no se descuenta ningún crédito.
  4. Abres covaly.store/confirmaciones y apruebas la solicitud.
  5. Si tu saldo alcanza, Covaly descuenta los créditos y ejecuta la operación.

POST /api/v1/reseller/stores

Crear una tienda

Crear una tienda cuesta 10 créditos por su primer mes. La API responde 202 Accepted y registra la solicitud sin descontar créditos todavía.

Payload de ejemplo

{
  "store_name": "Mi tienda",
  "slug": "mi-tienda",
  "owner_email": "dueno@ejemplo.com"
}
¿Qué sigue?

Te proporcionaremos un enlace para continuar con la confirmación. Revisa la solicitud, apruébala y Covaly descontará los 10 créditos para aprovisionar tu tienda.

Continuar a Confirmaciones →

POST /api/v1/reseller/stores/{application}/extend

Agregar tiempo

Cada mes adicional cuesta 10 créditos. Puedes solicitar entre 1 y 12 meses. Ejemplo: 3 meses necesitan 30 créditos al momento de confirmar.

{ "months": 3, "idempotency_key": "ext-2026-001" }

Consultar saldo

Actualmente el saldo y el historial de créditos se consultan desde tu perfil de Covaly. La API de Revendedores todavía no expone un endpoint público de saldo.

Importante: tu agente puede crear y consultar solicitudes, pero no puede aprobarlas ni gastar créditos por sí solo.

Ver solicitudes pendientes →