Documentação da API
Receba por PIX, cartão e boleto, pague por PIX e acompanhe tudo por webhook. Uma API REST, em JSON, com autenticação por chave.
Base URL e formato
Produção
https://api.apix.tec.br| Regra | Como funciona |
|---|---|
| Formato | Requisições e respostas em JSON (Content-Type: application/json) |
| Envelope | Toda resposta traz hasError e data; erros trazem error/message e statusCode |
| Valores de cobrança | Em centavos, número inteiro. R$ 99,90 = 9990 |
| Valores de saldo e saque | Em reais, número decimal. R$ 250,00 = 250.00 |
| Documentos | CPF ou CNPJ somente com dígitos |
| Datas | ISO 8601 em UTC (2026-09-16T12:00:00.000Z) |
Cobranças usam centavos e o módulo financeiro usa reais. É a diferença que mais gera erro na primeira integração.
Como um pagamento acontece
| Passo | O que acontece |
|---|---|
| 1. Cobrança | Você cria a cobrança e recebe o PIX copia e cola, o link do boleto ou o resultado do cartão |
| 2. Pagamento | O comprador paga. A confirmação é assíncrona: nunca chega na resposta do POST |
| 3. Confirmação | A APIX avisa o seu sistema por webhook; como alternativa, você consulta o status |
| 4. Saldo | O valor entra no seu saldo, já com as taxas descontadas |
| 5. Saque | Você envia o dinheiro para uma chave PIX pela API de saque |
Nunca libere o pedido pela resposta da criação da cobrança. Espere o status
AUTHORIZED, que chega por webhook.Primeira chamada
Crie uma chave em Integrações & APIs no painel e gere uma cobrança PIX de teste:
Cobrança PIX
curl -X POST "https://api.apix.tec.br/api/v1/direct-payments" \
-H "Content-Type: application/json" \
-H "X-API-Key: pk_live_a1b2c3d4..." \
-d '{
"amount": 9990,
"description": "Pedido #123",
"paymentMethod": "pix",
"customer": {
"name": "João da Silva",
"email": "joao@email.com",
"document": "12345678901",
"phone": "+5511999999999"
}
}'Em seguida veja autenticação, cobranças e saques.