Facturation

Informations sur le plan et la facturation du tenant. Cet endpoint permet au tenant de consulter son plan actuel et ses limites. Necessite le role manager ou superieur.

Important

La gestion des paiements et des abonnements est assuree en interne par l'equipe Avanter, qui s'integre a la passerelle de paiement Asaas. Les tenants n'interagissent pas directement avec la passerelle de paiement.

Endpoints

Methode	Endpoint	Description	Role Minimum
GET	/api/v1/billing/plan	Informations du plan actuel	manager

---

Consulter le Plan

Retourne les informations du plan actuel, les limites de ressources et l'utilisation courante du tenant. Cet endpoint est en lecture seule.

GET /api/v1/billing/plan

Exemple de Requete

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

Reponse de Succes (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
    }
  }
}

---

Plans Disponibles

Plan	Prix (BRL)	Appels Simultanes	Utilisateurs	Departements	Enregistrement	Transcription	Analytics
free	0	1	2	1	Non	Non	Basique
basic	99	3	10	3	Oui	Non	Basique
advanced	399	5	25	10	Oui	Oui	Complet
professional	699	10	50	20	Oui	Oui	Complet
enterprise	Sur devis	Illimite	Illimite	Illimite	Oui	Oui	Complet

---

Flux de Facturation

La facturation dans Voki est geree en interne par l'equipe Avanter :

1. Inscription du tenant : Le tenant s'inscrit via /api/signup/register en selectionnant un plan.
2. Creation du paiement : L'equipe Avanter cree le paiement dans Asaas via le panneau interne.
3. Confirmation automatique : Asaas envoie un webhook a POST /api/webhooks/asaas lorsque le paiement est confirme.
4. Activation de l'abonnement : Le statut de l'abonnement du tenant est mis a jour automatiquement.

Webhook Asaas

L'endpoint POST /api/webhooks/asaas est public (sans authentification JWT) mais protege par la validation du token Asaas. Les evenements traites incluent :

• PAYMENT_CONFIRMED - Paiement confirme
• PAYMENT_RECEIVED - Paiement recu
• PAYMENT_OVERDUE - Paiement en retard
• PAYMENT_REFUNDED - Paiement rembourse

---

Inscription

Le flux d'inscription pour les nouveaux tenants utilise des endpoints publics :

Valider un Document

POST /api/signup/validate-document

Verifie si un CPF/CNPJ est valide et n'est pas deja utilise.

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"
  }'

Enregistrer un Tenant

POST /api/signup/register

Cree le tenant et l'utilisateur administrateur. Le plan selectionne reste en attente jusqu'a ce que le paiement soit confirme par l'equipe Avanter via Asaas.

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