Registro de Empresa

Registre uma empresa na sua conta de integrador, conclua o pagamento e obtenha a chave de API.

Listar Planos Disponíveis

cURL
curl https://api.ixblix.app/api/plans \
  -u "int_xxxx:ixblix_integrator_token_xxxx"

Resposta (array de planos):

Resposta
[
  {
    "id": "uuid-of-plan",
    "name": "Starter",
    "billingType": "PERIOD",
    "period": "MONTHLY",
    "priceCents": 4900,
    "currency": "BRL",
    "isActive": true,
    "isPublic": true,
    "createdAt": "2026-01-01T00:00:00.000Z"
  }
]

Registrar uma Empresa

cURL
curl -X POST https://api.ixblix.app/api/companies/register \
  -u "int_xxxx:ixblix_integrator_token_xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Acme Corporation",
    "planId": "plan_starter"
  }'

Campos da Requisição

CampoObrigatórioDescrição
nameSimNome de exibição da empresa.
planIdSimID de um plano de assinatura.

A resposta inclui company e payment com um checkoutUrl — redirecione o dono da empresa para lá para concluir o pagamento.

Resposta
{
  "company": { "id": "cmp_xxxx", "name": "Acme Corporation", "status": "PENDING_PAYMENT" },
  "payment": {
    "transactionId": "company_cmp_xxxx-txn",
    "provider": "efi",
    "amountCents": 4900,
    "currency": "BRL",
    "confirmationUrl": "/api/companies/cmp_xxxx/activate/company_cmp_xxxx-txn",
    "status": "PENDING",
    "checkoutUrl": "https://api.ixblix.app/checkout/company_cmp_xxxx-txn"
  }
}

Ativar a Empresa

Após confirmação do pagamento:

cURL
curl -X POST https://api.ixblix.app/api/companies/{companyId}/activate/{transactionId} \
  -u "int_xxxx:ixblix_integrator_token_xxxx"

Resposta:

Resposta
{
  "apiKey": "smci_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "status": "ACTIVE"
}

Importante: A apiKey é exibida apenas uma vez. Armazene-a com segurança.

Tipos de Cobrança

TipoDescrição
MESSAGESCobrado por mensagem enviada ou recebida.
CONVERSATIONSCobrado por conversa criada.
COMPANYTaxa fixa por empresa.
TIMEAcesso baseado em tempo (ex: mensal).