LLiccenDocs

Documentação para desenvolvedores

Integre pagamentos com Liccen

A API de Liccen permite gerar cobranças Pix, enviar transferências e acompanhar o saldo da conta a partir do seu próprio sistema.

AutenticaçãoChaves de API, escopos e o header x-api-key.Cobranças PixGere o copia e cola Pix e acompanhe o pagamento.TransferênciasEnvie Pix a partir do saldo da conta.Saldo e contaConsulte o saldo disponível, o pendente e os dados da conta.WebhooksReceba eventos em tempo real e valide a assinatura.IdempotênciaRepita requisições de escrita sem duplicar operações.ErrosFormato do erro, códigos e como tratar cada um.Postman e IACollection pronta para importar e a documentação em Markdown para agentes.ChangelogO que mudou em cada versão da API.

URL base

Todos os endpoints públicos vivem sob o prefixo /v1.

Base URL
https://api.transakto.io/v1

Primeira chamada

Crie uma aplicação e uma chave em Configurações, API, na dashboard. A chave vai no header x-api-key. Requisições de escrita também exigem Idempotency-Key.

cURL
curl -X POST https://api.transakto.io/v1/charges \
  -H "x-api-key: sk_live_..." \
  -H "Idempotency-Key: pedido-1042" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 4990,
    "method": "pix",
    "reference": "pedido-1042",
    "customer": {
      "name": "Maria Souza",
      "email": "maria@exemplo.com.br",
      "document": "123.456.789-09"
    }
  }'

Convenções

Valores monetários são inteiros em centavos: 4990 é R$ 49,90. Datas são strings ISO 8601 em UTC. Identificadores são UUID.

Toda listagem devolve um envelope { object: "list", data, has_more } e usa paginação por cursor. Recursos individuais trazem o campo object dizendo o que são.

O que existe na v1

Cobranças Pix, transferências Pix, consulta de saldo e de conta, além da gestão dos webhooks da conta.

Boleto e cartão ainda não estão disponíveis pela API. Enviar "method": "boleto" ou "card" devolve METHOD_NOT_SUPPORTED.

Ambientes

Não há ambiente de sandbox separado: cada instalação da plataforma tem sua própria URL, e as chaves valem apenas para a empresa que as gerou. Para testar sem risco, crie uma aplicação dedicada e revogue a chave ao terminar.