Como funciona a Pré-Captura

Ao criar um pedido (order) é possível decidir se ele será capturado imediatamente ou se ficará em pré-captura.

• Se no body da requisição (criação do pedido) a propriedade capture for true, o pedido e a cobrança (charge) são capturados na hora.

• Se capture for false, o pedido e a cobrança ficam no status PRE_AUTHORIZED (pré-autorizados).

Para entender mais sobre a diferença entre Pedidos (Orders) e Cobranças (Charges), acesse: Pedido (Order) x Cobrança (Charge)

A pré-captura garante o limite no cartão do cliente, mas não finaliza a cobrança. Isso dá margem para que o vendedor possa executar validações adicionais (como antifraude, análise interna etc.) antes de concluir a captura.

Importante:

• O vendedor tem até 6 dias para capturar a cobrança.

• Se não for capturado dentro desse prazo, o pedido será cancelado automaticamente e tanto a order quanto a charge ficam como CANCELED.

Para capturar manualmente, utilize o endpoint: POST /v2/charges/{uuid}/capture

Veja a referencia completa aqui:

Capturar Cobrança

Respostas possíveis:

• Status PAID + retryable: false → captura realizada com sucesso.

• Status PRE_AUTHORIZED + retryable: true → captura não concluída, mas pode ser tentada novamente.