Ir para Produção

​

Visão Geral

​

Checklist de Produção

​

1. Autenticação

# .env.production
GARU_API_KEY=sk_live_sua_chave_producao
WEBHOOK_SECRET=seu_segredo_webhook

​

2. Produtos

• Todos os produtos criados com chaves sk_live_
• Preços corretos (conferir valores)
• Descrições e nomes revisados
• Imagens funcionando (URLs públicas)
• URLs de retorno apontando para produção

​

3. Webhooks

https://seusite.com/webhooks/garu

const crypto = require('crypto');

function validarAssinatura(payload, signature, secret) {
  const expected = crypto
    .createHmac('sha256', secret)
    .update(JSON.stringify(payload))
    .digest('hex');

  return crypto.timingSafeEqual(
    Buffer.from(signature),
    Buffer.from(expected)
  );
}

async function processarWebhook(data) {
  const jaProcessado = await verificarProcessado(data.id);
  if (jaProcessado) return;

  await processarPagamento(data);
  await marcarComoProcessado(data.id);
}

​

4. Tratamento de Erros

• Retry com backoff exponencial para erros 429
• Logs detalhados para debugging
• Alertas para erros críticos
• Fallback para falhas de webhook

async function criarProdutoComRetry(dados, tentativas = 3) {
  for (let i = 0; i < tentativas; i++) {
    try {
      return await criarProduto(dados);
    } catch (error) {
      if (error.status === 429 && i < tentativas - 1) {
        await sleep(Math.pow(2, i) * 1000);
        continue;
      }
      throw error;
    }
  }
}

​

5. Segurança

• HTTPS em todos os endpoints
• Chaves de API em variáveis de ambiente
• Validação de assinatura em webhooks
• Logs não expõem dados sensíveis
• Acesso ao Dashboard com 2FA habilitado

​

6. Monitoramento

​

Testes Finais

​

Teste de Pagamento Completo

​

Teste de Falhas

• Testar comportamento quando webhook falha
• Testar rate limiting (429)
• Testar com chave inválida
• Testar com dados inválidos

​

Migração de Teste para Produção

// config.js
const config = {
  development: {
    apiKey: process.env.GARU_TEST_KEY,
    baseUrl: 'https://garu.com.br/api'
  },
  production: {
    apiKey: process.env.GARU_LIVE_KEY,
    baseUrl: 'https://garu.com.br/api'
  }
};

module.exports = config[process.env.NODE_ENV || 'development'];

​

Pós-Lançamento

​

Primeiros Dias

• Monitore de perto todas as transações
• Verifique se webhooks estão sendo recebidos
• Responda rapidamente a problemas reportados

​

Manutenção Contínua

• Rotacione chaves de API periodicamente
• Mantenha logs por pelo menos 90 dias
• Revise métricas de conversão
• Atualize integrações conforme necessário

​

Suporte

1. Verifique os logs do seu servidor
2. Consulte a Solução de Problemas
3. Acesse o Dashboard para ver status das transações
4. Entre em contato: contato@garu.com.br