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

# Perguntas frequentes

> Respostas curtas para o que mais aparece.

<AccordionGroup>
  <Accordion title="Quanto tempo leva para uma cobrança ser confirmada?">
    Assim que o motor de pagamentos registra o Pix, ele avisa o V4 Pay e a cobrança vira `paid`.
    Na prática, segundos. Se você cadastrou um [webhook](/webhooks), o seu servidor é
    avisado logo depois.
  </Accordion>

  <Accordion title="Criei a conta e não consigo emitir em produção. Por quê?">
    Toda conta nova opera **só em modo teste** até a equipe do V4 Pay aprovar o cadastro
    — dados da empresa e três documentos. É o `409` com `codigo: PRODUCAO_NAO_LIBERADA`
    que você está vendo. O passo a passo está em
    [Aprovação de produção](/aprovacao-de-producao).
  </Accordion>

  <Accordion title="Existe sandbox?">
    Existe, e completo: crie uma chave com `environment: "test"` (`v4pay_test_…`), emita
    cobranças, simule o pagamento com `POST /pix/simulate-payment` e receba os webhooks
    — tudo sem mover dinheiro. É onde toda conta nova começa. Veja
    [Ambiente de testes](/ambiente-de-testes).
  </Accordion>

  <Accordion title="O dinheiro passa pela conta do V4 Pay?">
    Depende do [modo de recebimento](/modo-de-recebimento) em operação. **Hoje, no modo
    conta única, passa**: a cobrança entra na conta do V4 Pay e o repasse ao lojista é
    manual. No modo subconta (o desenho de destino), não: a taxa é separada na origem e
    o restante cai direto na conta do lojista.
  </Accordion>

  <Accordion title="A cobrança devolve 409. O que significa?">
    Leia o `codigo` da resposta: `PRODUCAO_NAO_LIBERADA` é a
    [aprovação de produção](/aprovacao-de-producao) pendente (o caso mais comum);
    `SUBCONTA_INEXISTENTE` e `SUBCONTA_NAO_APROVADA` são do modo subconta, quando o
    cadastro da conta de recebimento falta ou está em análise. A lista completa, com o
    que fazer em cada um, está em [Erros e códigos](/erros-e-codigos).
  </Accordion>

  <Accordion title="Posso cancelar ou devolver um Pix pela API?">
    As rotas `POST /pix/cancel` e `POST /pix/refund` existem, mas **ainda não
    executam o cancelamento nem a devolução na origem**. Hoje elas respondem `502`
    explicando isso. Está documentado na Referência da API para ninguém ser pego de surpresa.
  </Accordion>

  <Accordion title="Como sei que um webhook veio mesmo do V4 Pay?">
    Cada chamada leva o header `X-V4Pay-Signature`, que é o HMAC-SHA256 do corpo
    calculado com o segredo do seu endpoint. Compare antes de confiar — o passo a passo
    está em [Webhooks](/webhooks).
  </Accordion>

  <Accordion title="Perdi a chave de API. Consigo ver de novo?">
    Não. A chave aparece **uma única vez**, na resposta de `POST /api-keys`. Depois só o
    prefixo fica visível. Crie outra e revogue a antiga com `DELETE /api-keys/{id}`.
  </Accordion>

  <Accordion title="A API tem limite de requisições?">
    As rotas públicas e as de login/cadastro têm limite por IP; as demais não têm limite
    próprio hoje. A tabela completa está em [Limites](/limites).
  </Accordion>
</AccordionGroup>