Skip to main content
O ambiente sandbox permite testar integrações sem movimentar dinheiro real.

​
Base URL

AmbienteURL
Produçãohttps://api.linka.com
Sandboxhttps://sandbox.api.linka.com

​
Credenciais

Use API Keys com prefixo sk_test_ para o sandbox. Crie-as no dashboard em modo de teste. 
curl -X POST https://sandbox.api.linka.com/transactions \
  -H "Authorization: Bearer sk_test_sua_key_sandbox" \
  -H "Idempotency-Key: test-uuid-aqui" \
  -H "Content-Type: application/json" \
  -d '{"amount": 1000, "paymentMethod": "PIX", ...}'

​
Comportamento do sandbox

​
PIX

  • QR Codes gerados sao validos mas não processam pagamentos reais
  • Transações mudam automaticamente para PAID após 30 segundos (simulacao)
  • Webhooks sao enviados normalmente para sua URL configurada

​
Boleto

  • Boletos gerados possuem código de barras ficticio
  • Simulacao de pagamento via endpoint de teste

​
Cartão

  • Use os cartões de teste abaixo

​
Cartões de teste

NúmeroResultado
4111 1111 1111 1111Aprovado
4000 0000 0000 0002Recusado — saldo insuficiente
4000 0000 0000 0069Recusado — cartão expirado
4000 0000 0000 0077Recusado — fraude detectada
Para todos os cartões de teste:
  • CVV: qualquer 3 digitos (ex: 123)
  • Validade: qualquer data futura (ex: 12/30)
  • Nome: qualquer nome

​
Documentos de teste

CPFCenário
000.000.000-00Seller aprovado automaticamente
111.111.111-11Seller pendente de análise
222.222.222-22Seller rejeitado

​
Limitacoes do sandbox

  • Saques não transferem dinheiro real
  • Webhooks podem ter delay maior que produção
  • Dados sao resetados periodicamente
  • Rate limits sao os mesmos de produção
O sandbox compartilha a mesma API e mesmos endpoints que produção. A única diferenca e a base URL e o prefixo das API Keys.