Skip to main content

​
1. Obtenha suas credenciais

Faça login no Dashboard e acesse a seção Integrações para gerar uma API Key. Você receberá um apiKey e um apiSecret. Guarde o apiSecret — ele não será exibido novamente.

​
2. Autentique-se

Use a API Key no header Authorization: 
curl -X POST https://api.linka.com/transactions \
  -H "Authorization: Bearer sk_live_sua_api_key_aqui" \
  -H "Content-Type: application/json"

​
3. Crie uma transação PIX

curl -X POST https://api.linka.com/transactions \
  -H "Authorization: Bearer sk_live_sua_api_key_aqui" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 550e8400-e29b-41d4-a716-446655440000" \
  -d '{
    "amount": 1000,
    "paymentMethod": "PIX",
    "customer": {
      "name": "Joao Silva",
      "document": "12345678900",
      "email": "[email protected]"
    }
  }'

​
Resposta

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "WAITING_PAYMENT",
  "amount": 1000,
  "feeAmount": 0,
  "netAmount": 0,
  "paymentMethod": "PIX",
  "pixQrCode": "00020126580014br.gov.bcb.pix...",
  "pixQrCodeBase64": "data:image/png;base64,...",
  "expiresAt": "2026-04-11T15:30:00.000Z",
  "customer": {
    "name": "Joao Silva",
    "email": "j***@email.com"
  },
  "createdAt": "2026-04-11T14:30:00.000Z"
}

​
4. Configure um webhook

Cadastre uma URL para receber notificações quando o pagamento for confirmado: 
curl -X POST https://api.linka.com/webhooks \
  -H "Authorization: Bearer sk_live_sua_api_key_aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://seusite.com/webhooks/linka",
    "events": ["TRANSACTION_PAID", "TRANSACTION_FAILED"]
  }'

​
5. Receba a confirmação

Quando o cliente pagar o PIX, sua URL recebera um POST: 
{
  "event": "TRANSACTION_PAID",
  "data": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "status": "PAID",
    "amount": 1000,
    "feeAmount": 15,
    "netAmount": 985,
    "paidAt": "2026-04-11T14:31:00.000Z"
  },
  "signature": "sha256=..."
}
Valide o header x-webhook-signature para garantir que o webhook veio da Linka. Veja Webhooks para detalhes.

​
Próximo passos

Autenticação

Como obter e usar sua API Key

Idempotencia

Evite cobranças duplicadas

Guia PIX

Fluxo completo de PIX recebimento

Status de transação

Maquina de estados completa