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

# Modo de recebimento

> Para onde vai o dinheiro das suas cobranças: os dois modos que o V4 Pay opera, e o que muda para você em cada um.

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](/aprovacao-de-producao).
* **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](/aprovacao-de-producao) do V4 Pay continua valendo **antes**
  de tudo isso.

## Em resumo

|                        | Conta única (hoje)          | Subconta (destino)                            |
| ---------------------- | --------------------------- | --------------------------------------------- |
| Onde o dinheiro cai    | conta do V4 Pay             | direto na conta do lojista                    |
| Cadastro de empresa    | não é preciso               | obrigatório, com análise do motor             |
| Taxa do V4 Pay         | acertada no repasse manual  | separada na origem (split)                    |
| Saque pela plataforma  | suspenso (`REPASSE_MANUAL`) | não se aplica — o dinheiro já está com você   |
| O que libera a emissão | aprovação de produção       | aprovação de produção **+** subconta aprovada |

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á.