Captura

ℹ️

Válido somente para transações com cartão de crédito.

Consulte o exemplo de requisição em: Capturar transação de cartão de crédito.

A captura confirma a autorização da transação para que o valor seja liquidado. Ao capturar uma transação, o valor é cobrado do cartão e incluído na fatura do comprador. Apenas transações capturadas são liquidadas para a loja.

A Cielo permite captura total ou parcial. Há dois tipos de captura:


Nesta seção, apresentamos as orientações para fazer a captura posterior.

Ao realizar uma captura posterior, a loja confirma que o valor autorizado poderá ser cobrado pela instituição financeira emissora do cartão.

⚠️

Atenção

A captura possui prazo de execução padrão de 7 dias corridos. Verifique em seu cadastro Cielo se sua afiliação está configurada para esse prazo.

Após esse período, não é possível capturar a transação. Se a captura não ocorrer dentro do prazo, a autorização expira e o valor não será cobrado no cartão do comprador e o limite será liberado.

Regras gerais de captura

  • Só é possível capturar transações com status 1 (Authorized). A transação com status 1 (Authorized) foi aprovada pelo emissor, mas o valor ainda não foi cobrado no cartão do comprador. A captura é o próximo passo para transferir o valor para a conta da loja;
  • Após a captura, a transação muda para o status status 2 (PaymentConfirmed). A captura indica que o valor da compra foi efetivamente cobrado no cartão do comprador e transferido para a conta da loja.

Após a captura, não é possível realizar capturas adicionais na mesma transação.

Captura parcial e total

A Cielo permite capturar todo o valor autorizado ou somente parte dele, conforme a necessidade da loja.

  • Para captura parcial, envie o campo Amount na requisição de captura com o valor desejado a capturar;
  • Para captura total, não envie o campo Amount. Será considerado o valor total da autorização.

Após o envio da captura, não é possível enviar novas capturas para a mesma transação.

ℹ️

Importante

Transações com valor inferior a R$ 0,20 centavos na agenda financeira não são liquidadas.

Não recomendamos realizar a captura de valores menores que R$ 0,20 centavos.

⚠️

Atenção

O campo ServiceTaxAmount é exclusivo para empresas aéreas.