Captura Manual - como e quando utilizar

A captura manual permite que o estabelecimento tenha controle sobre quando e a quantia do valor da autorização a ser confirmada.

Esse modelo possui um nicho mais específico onde há uma gestão de negócio enquanto uma transação está autorizada, para que aja uma confirmação posterior quanto a garantia de serviço e valor.

📘
Por que usar?
Esse modelo é útil quando existe um intervalo entre a aprovação do cartão e o momento em que o estabelecimento realmente pode assumir que a venda deve ser concluída.

Casos de uso típicos

Por padrão, Hotéis, Pousadas e Locadoras utilizam a reserva do limite do cartão como caução para garantir um pagamento prévio da estadia. Quando o hospede se retira, o caução é confirmado de forma parcial ou integral de acordo as políticas do estabelecimento.

As Concessionária costumam efetuar uma autorização como sinal de interesse de compra de um veículo, garantindo o pagamento parcial do veículo previamente.

Já as Lojas de eletrométricos costumam trabalhar com estoques, onde há a possibilidade do produto solicitado não estar disponível após a compra. Para evitar atritos, o estabelecimento faz apenas reserva do limite, para então confirmar o estoque e consequentemente a captura da transação. Dessa forma, caso o produto não esteja diposnivel, será possivel cancelar a autorização e retornar o limite imediatamente ao comprador.

Cenário	Por que a captura manual ajuda
Hotel ou pousada	Permite reservar limite como garantia e confirmar o valor devido após o check-out.
Locadora	Permite manter uma pré-autorização durante o período de locação e confirmar o valor final depois da devolução.
Produto sob encomenda	Evita efetivar a cobrança antes de confirmar produção, disponibilidade ou envio.
Estoque sujeito a confirmação	Permite cancelar a autorização caso o produto não esteja disponível.
Valor final variável	Dá ao estabelecimento tempo para apurar o valor antes da confirmação, dentro das regras aplicáveis.

Exemplo: e-commerce com confirmação de estoque

flowchart TD
A[Cliente realiza o pedido] --> B[Autorização aprovada]
B --> C[Limite reservado]
C --> D{Estoque confirmado?}
D -->|Sim| E[Capturar transação]
E --> F[Pagamento confirmado]
D -->|Não| G[Cancelar autorização]
G --> H[Reserva de limite liberada conforme o fluxo aplicável]

A captura manual permite que a decisão financeira acompanhe uma condição real da operação.

Exemplo: hotel ou locadora

Na entrada, retirada ou contratação, o estabelecimento pode solicitar uma autorização para reservar limite. Durante a prestação do serviço, o valor definitivo ainda pode depender de consumo, diárias adicionais, combustível ou outros itens. Quando o valor final é conhecido, a captura confirma a cobrança dentro das regras disponíveis.

Impacto para a operação

A equipe ou o sistema precisa acompanhar autorizações pendentes de captura.
É necessário definir claramente o evento que dispara a captura.
Quando a venda não deve prosseguir, a autorização deve ser cancelada conforme o fluxo aplicável.
O prazo disponível para capturar pode variar conforme adquirente, autorizadora e configuração comercial.

⚠️
Autorizações não são permanentes
A reserva de limite é temporária. Não assuma um prazo universal: confirme as regras da adquirente/autorizadora utilizada e mantenha monitoramento para não deixar autorizações expirarem sem tratamento.

Captura total ou parcial

A captura pode confirmar o valor autorizado integralmente ou apenas parte dele. O comportamento exato, limites e condições devem ser validados na Referência da API e nas regras comerciais aplicáveis.

Na integração

A escolha pela captura manual é feita na criação da Venda e a confirmação posterior ocorre sobre a Transação autorizada. Consulte a Referência da API para o valor exato do campo de captura, endpoint, pré-condições e exemplos de request/response.