> ## Documentation Index
> Fetch the complete documentation index at: https://docs.killb.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Melhores Práticas

> Diretrizes de integração prontas para produção

## Segurança

<AccordionGroup>
  <Accordion title="Proteger Credenciais" icon="lock">
    * Armazene chaves de API em variáveis de ambiente
    * Nunca commite secrets no controle de versão
    * Rotacione chaves regularmente
    * Use serviços de gerenciamento de secrets
  </Accordion>

  <Accordion title="Validar Entradas" icon="check">
    * Valide entradas do usuário no lado do cliente
    * Sanitize dados antes de chamadas API
    * Verifique formatos antes do envio
    * Previna ataques de injeção
  </Accordion>

  <Accordion title="Proteger Webhooks" icon="shield">
    * Sempre verifique assinaturas
    * Use apenas HTTPS
    * Implemente rate limiting
    * Registre atividade suspeita
  </Accordion>
</AccordionGroup>

## Desempenho

<AccordionGroup>
  <Accordion title="Cache Estrategicamente" icon="database">
    * Cache dados de usuário (1 hora TTL)
    * Cache listas de bancos (24 horas)
    * Cache saldos (5 minutos)
    * Invalide em webhooks
  </Accordion>

  <Accordion title="Otimizar Chamadas API" icon="bolt">
    * Use webhooks em vez de polling
    * Agrupe operações relacionadas em lote
    * Implemente deduplicação de requisições
    * Use paginação para grandes conjuntos de dados
  </Accordion>

  <Accordion title="Lidar com Erros Graciosamente" icon="triangle-exclamation">
    * Implemente lógica de retry
    * Use backoff exponencial
    * Registre erros para depuração
    * Mostre mensagens amigáveis ao usuário
  </Accordion>
</AccordionGroup>

## Experiência do Usuário

<AccordionGroup>
  <Accordion title="Comunicação Clara" icon="comment">
    * Mostre valores exatos e taxas
    * Exiba tempos de processamento
    * Forneça atualizações de status
    * Explique requisitos claramente
  </Accordion>

  <Accordion title="KYC Progressivo" icon="stairs">
    * Comece com L0/L1
    * Atualize quando usuário precisar de limites mais altos
    * Explique benefícios da verificação
    * Torne o processo KYC suave
  </Accordion>

  <Accordion title="Lidar com Casos Extremos" icon="flask">
    * Expiração de cotação
    * Falhas de pagamento
    * Problemas de rede
    * Transações lentas
  </Accordion>
</AccordionGroup>

## Idempotência

Use `externalId` para idempotência:

```javascript theme={null}
// Previne ramps duplicados em retry
const createRamp = async (quoteId, userId, accountId, orderId) => {
  return await fetch('/api/v2/ramps', {
    method: 'POST',
    headers: { /* headers */ },
    body: JSON.stringify({
      quotationId: quoteId,
      userId: userId,
      accountId: accountId,
      externalId: `order-${orderId}` // Chave de idempotência
    })
  });
};
```

## Lista de Verificação de Produção

<Steps>
  <Step title="Segurança">
    * [ ] Chaves de API em variáveis de ambiente
    * [ ] Verificação de assinatura de webhook
    * [ ] Apenas HTTPS
    * [ ] Validação de entrada
  </Step>

  <Step title="Tratamento de Erros">
    * [ ] Lógica de retry implementada
    * [ ] Mensagens de erro amigáveis
    * [ ] Registro de erros
    * [ ] Alertas de monitoramento
  </Step>

  <Step title="Testes">
    * [ ] Todos os fluxos testados no sandbox
    * [ ] Casos extremos tratados
    * [ ] Entrega de webhook verificada
    * [ ] Teste de carga concluído
  </Step>

  <Step title="Monitoramento">
    * [ ] Logging configurado
    * [ ] Rastreamento de erros (Sentry, etc.)
    * [ ] Monitoramento de desempenho
    * [ ] Alertas configurados
  </Step>
</Steps>

## Próximos Passos

<Card title="Ir ao Vivo" icon="rocket" href="/pt/sandbox">
  Mude do sandbox para produção
</Card>