Skip to main content
Transitar do sandbox para produção envolve verificação da conta, liberação de capacidades e uma revisão da integração. Siga este checklist na ordem.

​
1. Verificação da conta (KYC/KYB)

1

Complete o cadastro legal

Dados do titular/empresa (PF ou PJ), endereço e documentos no painel. A verificação é feita por nosso parceiro de identidade.
2

Aguarde a aprovação

Você recebe um evento merchant.status.updated.v1 (se tiver webhooks configurados) e a confirmação no painel.
3

Liberação de capacidades

Com a conta aprovada, as capacidades de pagamento (PIX, cartão) são habilitadas. Capacidade desabilitada retorna 403 MERCHANT_CAPABILITY_DISABLED.

​
2. Preparar a integração

  • Chaves de API de sandbox geradas
  • Conectar os Webhooks e eventos no seu URL de testes
  • Criar os produtos, ofertas e preços
  • Garantir que sua API sabe lidar com rate-limit, indisponibilidades e idempotência

​
3. Ativar produção

1

Criar chaves live

No painel, crie chaves kbt_live_ com os escopos mínimos por integração. Configure a base URL https://api.korbit.com.br.
2

Registrar webhooks de produção

Crie assinaturas de webhook no ambiente live apontando para seu endpoint de produção.
3

Validar primeira venda real

Faça uma venda de valor baixo, confirme o webhook payment.succeeded.v1, o saldo e a liberação dos recursos.
4

Acompanhar o primeiros ciclos

Monitore pedidos, saldo e dead-letters de webhook nos primeiros dias.
Não mova produção para cima de chaves de teste “por praticidade”: chaves kbt_test_ são recusadas no ambiente live e dados de sandbox não migram para produção.

​
Suporte

Durante o go-live, o time da Korbit acompanha a operação. Ao abrir um chamado, inclua sempre o requestId das requisições com problema. Veja Suporte.