DOCUMENTACIÓN / API REVENDEDORES / CRÉDITOS Y SALDO
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.
Cómo funciona
- Tu cuenta tiene un saldo de créditos.
- Solicitas crear una tienda o agregar meses mediante la API.
- Covaly crea una solicitud pendiente; en este momento no se descuenta ningún crédito.
- Abres
covaly.store/confirmacionesy apruebas la solicitud. - 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"
} 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 →