Aprovação de produção

Todo lojista começa em modo teste. Para receber dinheiro de verdade, o cadastro precisa ser aprovado pela equipe do V4 Pay.

Esta página é para quem acabou de criar a conta e quer entender o que falta para operar em produção — e para o desenvolvedor que levou um 409 com codigo: PRODUCAO_NAO_LIBERADA e quer saber o que fazer.

A regra

Toda conta nova nasce operando só em modo teste. Dá para integrar, criar chave de teste, emitir cobrança simulada e receber webhooks — tudo, menos dinheiro de verdade. Para liberar a produção, a equipe do V4 Pay analisa o cadastro: os dados da empresa e três documentos.

O status da sua conta aparece no painel (em Ativar produção) e em GET /producao:

Status	Significado
sandbox	estado inicial: só opera em teste
pending	cadastro enviado, aguardando a análise
approved	produção liberada
rejected	recusado — o motivo aparece na resposta; corrija e reenvie

O que é exigido

Dados da empresa (salvos pelo painel ou por PUT /auth/profile): razão social ou nome da loja (company), CPF ou CNPJ válido, telefone, endereço com número, bairro, CEP e o tipo de empresa. O campo faltando de GET /producao lista o que ainda está vazio.

Três documentos, enviados em POST /producao/documentos (ou pelo painel):

tipo	O que enviar
cnpj_ou_contrato_social	cartão CNPJ ou contrato social
documento_responsavel	documento com foto do responsável
comprovante_endereco	comprovante de endereço da empresa

PDF, JPG ou PNG, até 4 MB por arquivo. O conteúdo é conferido pelos primeiros bytes — renomear a extensão não passa. Reenviar um tipo substitui o anterior.

O envio de documentos só funciona com a sessão do painel e pelo titular da conta: chave de API responde 403 (SOMENTE_PAINEL) e membro de loja compartilhada também (SOMENTE_TITULAR). Documento de identificação é assunto do dono.

O fluxo

1. Complete os dados e envie os documentos

   Em Ativar produção no painel. Enquanto o status é sandbox (ou rejected), dá para trocar e remover documentos à vontade.

2. Envie para análise

   POST /producao/solicitar (ou o botão do painel). Se faltar algo, a resposta é 400 com codigo: CADASTRO_INCOMPLETO e as listas faltando e documentos_faltando. Enviado, o status vira pending e os documentos ficam travados até a análise terminar.

3. Aguarde a equipe

   Aprovado, você recebe um e-mail e o status vira approved — o botão Ir para produção do painel ativa. Recusado, o motivo chega por e-mail e em reject_reason; corrija e reenvie (volta para a fila).

O que fica bloqueado até a aprovação

Tudo que envolve dinheiro de verdade responde com codigo: PRODUCAO_NAO_LIBERADA e um bloco producao dizendo em que pé o cadastro está:

Ação	Resposta
Trocar a sessão para produção (POST /auth/environment com live)	409
Criar chave v4pay_live_ (POST /api-keys com environment: live)	409
Usar uma chave v4pay_live_ que já exista	403 em toda chamada
Emitir cobrança em produção (Pix, link, checkout, assinatura, POST /charges)	409
Sacar (POST /withdrawals)	409

{
  "error": {
    "message": "Sua conta ainda opera em modo teste. Envie os dados da empresa e os documentos para liberar a produção.",
    "codigo": "PRODUCAO_NAO_LIBERADA",
    "producao": { "status": "sandbox", "motivo_recusa": null }
  }
}

O login também reflete a regra: enquanto não aprovado, todo token de sessão nasce em modo teste — não existe caminho que deixe uma conta nova em produção por engano.

Pagamento de cobrança já emitida sempre confirma, e consultar o que você emitiu sempre funciona: o bloqueio vale só para criar coisa nova em produção.

E depois de aprovado?

Depende do modo de recebimento do servidor. No modo subconta, o cadastro da conta de recebimento (e a análise do próprio motor de pagamentos) continua valendo por cima desta aprovação; no modo conta única, aprovar aqui já basta para emitir.