Facturacion

Informacion del plan y facturacion del tenant. Este endpoint permite al tenant consultar su plan actual y limites. Requiere rol de manager o superior.

Importante

La gestion de pagos y suscripciones es manejada internamente por el equipo de Avanter, que se integra con la pasarela de pago Asaas. Los tenants no interactuan directamente con la pasarela de pago.

Endpoints

Metodo	Endpoint	Descripcion	Rol Minimo
GET	/api/v1/billing/plan	Informacion del plan actual	manager

---

Consultar Plan

Devuelve la informacion del plan actual, limites de recursos y uso corriente del tenant. Este es un endpoint de solo lectura.

GET /api/v1/billing/plan

Ejemplo de Request

curl -X GET https://voki.avanter.com.br/api/v1/billing/plan \
  -H "Authorization: Bearer eyJhbGci..." \
  -H "X-Tenant: avanter"

Respuesta Exitosa (200)

{
  "data": {
    "plan": "professional",
    "status": "active",
    "max_concurrent_calls": 10,
    "max_users": 50,
    "max_departments": 20,
    "recording_enabled": true,
    "transcription_enabled": true,
    "analytics_enabled": true,
    "current_period_start": "2026-02-01T00:00:00Z",
    "current_period_end": "2026-03-01T00:00:00Z",
    "usage": {
      "active_users": 12,
      "active_departments": 5,
      "calls_this_month": 342,
      "recording_storage_mb": 2048
    }
  }
}

---

Planes Disponibles

Plan	Precio (BRL)	Llamadas Simultaneas	Usuarios	Departamentos	Grabacion	Transcripcion	Analytics
free	0	1	2	1	No	No	Basico
basic	99	3	10	3	Si	No	Basico
advanced	399	5	25	10	Si	Si	Completo
professional	699	10	50	20	Si	Si	Completo
enterprise	Personalizado	Ilimitado	Ilimitado	Ilimitado	Si	Si	Completo

---

Flujo de Facturacion

La facturacion en Voki es gestionada internamente por el equipo de Avanter:

1. Registro del tenant: El tenant se registra via /api/signup/register seleccionando un plan.
2. Creacion del pago: El equipo de Avanter crea el pago en Asaas a traves del panel interno.
3. Confirmacion automatica: Asaas envia un webhook a POST /api/webhooks/asaas cuando el pago es confirmado.
4. Activacion de la suscripcion: El estado de la suscripcion del tenant se actualiza automaticamente.

Webhook Asaas

El endpoint POST /api/webhooks/asaas es publico (sin autenticacion JWT) pero protegido por validacion de token de Asaas. Los eventos procesados incluyen:

• PAYMENT_CONFIRMED - Pago confirmado
• PAYMENT_RECEIVED - Pago recibido
• PAYMENT_OVERDUE - Pago vencido
• PAYMENT_REFUNDED - Pago reembolsado

---

Signup

El flujo de signup para nuevos tenants utiliza endpoints publicos:

Validar Documento

POST /api/signup/validate-document

Verifica si un CPF/CNPJ es valido y no esta en uso.

curl -X POST https://voki.avanter.com.br/api/signup/validate-document \
  -H "Content-Type: application/json" \
  -d '{
    "document": "12.345.678/0001-90",
    "document_type": "cnpj"
  }'

Registrar Tenant

POST /api/signup/register

Crea el tenant y el usuario administrador. El plan seleccionado queda pendiente hasta que el pago sea confirmado por el equipo de Avanter via Asaas.

curl -X POST https://voki.avanter.com.br/api/signup/register \
  -H "Content-Type: application/json" \
  -d '{
    "company_name": "Nueva Empresa",
    "document": "12.345.678/0001-90",
    "document_type": "cnpj",
    "admin_name": "Admin",
    "admin_email": "admin@nuevaempresa.com",
    "admin_password": "contrasenaSegura123",
    "plan": "professional"
  }'