Skip to main content
Esta página é para o lojista que quer saber onde o dinheiro cai — e para quem levou um 409 com codigo: REPASSE_MANUAL ao tentar sacar. O V4 Pay tem dois modos de recebimento. Qual está ativo é uma configuração do servidor, não uma escolha por lojista — e GET /receiving-account diz em qual você está (no modo conta única a resposta traz modo: "conta_unica").

​
Conta única — o modo em operação hoje

As cobranças são emitidas na conta principal do V4 Pay. O dinheiro entra lá, e o repasse ao lojista é feito manualmente pela equipe. O que isso significa na prática:
  • Não é preciso cadastrar empresa para receber: GET /receiving-account já responde aprovado. A única exigência é a aprovação de produção.
  • O saque pela plataforma está suspenso: POST /withdrawals responde 409 com codigo: REPASSE_MANUAL. O repasse é combinado com a equipe.
  • O saldo exibido é o valor bruto das cobranças pagas (fee_amount fica 0): a taxa do V4 Pay é acertada no repasse, não descontada na cobrança.

​
Subconta — o desenho de destino

Cada lojista tem uma subconta própria no motor de pagamentos, aberta pelo cadastro da empresa (POST /receiving-account). A cobrança nasce na subconta, a taxa do V4 Pay é separada na origem via split, e o restante cai direto na conta do lojista — o dinheiro não passa pelo V4 Pay. Neste modo:
  • o cadastro da empresa é obrigatório, e a subconta passa pela análise do próprio motor de pagamentos (documentos e selfie pelo link_documentos de GET /receiving-account);
  • emitir antes de ter subconta responde 409 SUBCONTA_INEXISTENTE; com a análise pendente, 409 SUBCONTA_NAO_APROVADA — a resposta traz o bloco aprovacao dizendo o que falta;
  • a aprovação de produção do V4 Pay continua valendo antes de tudo isso.

​
Em resumo

A troca de modo é transparente para a integração: as rotas são as mesmas, e os códigos de erro dizem em qual situação você está.