Skip to main content

​
Visao geral

A Linka API e uma API REST que permite processar pagamentos via PIX, Boleto e Cartão de Crédito, gerenciar saques, consultar extratos e configurar webhooks. Todos os dados financeiros sao expressos em centavos (integers) para evitar erros de arredondamento. Base URL 
https://api.linka.com

​
Autenticação

Todas as requisições são autenticadas via API Key no header Authorization: 
Authorization: Bearer sk_live_sua_api_key_aqui
A API Key é gerada pelo seller no Dashboard, na seção Integrações. Veja Autenticação para detalhes.
PrefixoAmbiente
sk_live_Produção
sk_test_Sandbox

​
Valores monetarios

Todos os valores monetarios sao representados em centavos (inteiros, sem decimais):
Valor realValor na API
R$ 1,00100
R$ 10,001000
R$ 150,0015000
R$ 1.000,00100000

​
Idempotencia

Endpoints de criacao de transações e saques exigem o header Idempotency-Key. Use um UUID v4 único por requisicao. Retries com a mesma chave retornam a resposta original sem criar duplicatas. 
Idempotency-Key: 550e8400-e29b-41d4-a716-446655440000

​
Paginação

A maioria dos endpoints de listagem suporta paginação via take e skip:
ParametroDescriçãoPadrão
takeRegistros por página10
skipRegistros a pular (offset)0
Alguns endpoints também suportam paginação por cursor via cursor e nextCursor.

​
Formato de data

Todas as datas seguem o formato ISO 8601: 
2026-03-06T10:00:00.000Z
Filtros de data aceitam o formato YYYY-MM-DD.

​
Erros

A API retorna erros no formato JSON padronizado: 
{
  "statusCode": 400,
  "message": "Descrição do erro",
  "error": "Bad Request"
}
StatusSignificado
400Dados inválidos na requisição
401Não autenticado
403Sem permissão para o recurso
404Recurso não encontrado
409Conflito (ex: Idempotency-Key já usada)
422Erro no processamento do pagamento
500Erro interno do servidor

​
Ciclo de vida de uma transação

PENDING → PROCESSING → AUTHORIZED → PAID
                     ↘ REFUSED
                     ↘ FAILED
PAID → REFUNDED
PAID → CHARGEDBACK

​
Ciclo de vida de um saque

PENDING → APPROVED → PROCESSING → COMPLETED
        ↘ REJECTED
                   ↘ FAILED