Sobre a utilização da captura automática e manual
Explicação sobre Autorização e Captura
Para trabalhar com captura manual, é importante entender conceitos básicos sobre o processo de uma transação de crédito, o que é uma autorização e captura e suas diferenças.
Autorização - o que é?
Em uma transação com cartão de crédito, a "autorização" (também conhecida como pré-autorização) e "captura" (também conhecida como confirmação) são duas etapas distintas, mas complementares.
A autorização é o processo inicial em uma transação com cartão de crédito.
A autorização garante a reserva do limite do cartão, que posteriormente poderá ser capturado ou cancelado.
Nessa primeira etapa, o gateway em conjunto com a adquirente e banco, realizam verificações para certificar a autenticidade do cartão, se é valido, está ativo e principalmente se há limite disponível,
Caso essas validações ocorram com sucesso, a autorização é gerada e o portador cobrado no ato.
Após isso, posteriormente o pagamento deve ser seguido por uma captura (confirmação) como forma de assegurar a cobrança e liquidação do pagamento.
Em resumo:
- A Autorização é como um "ok" inicial que garante que a tentativa de compra foi realizada, e quando há sucesso o valor é cobrado imediatamente no cartão
- A Captura é o ato de efetivar a compra pelo estabelecimento.
Cancelamento de autorizaçãoEnquanto uma transação ainda estiver autorizada, ela estará apta a ser cancelada pelo estabelecimento a qualquer momento, retornando assim o limite do cartão de forma imediata. Diferentemente de uma transação capturada, onde o valor já foi assegurado e o cancelamento seguira o processo de reembolso.
Captura - o que é?
A captura é a etapa final em que o valor da compra é efetivamente lançado na fatura do cartão e transferido para liquidação ao estabelecimento.
A liquidação do pagamento pela adquirente só começa a ser contabilizado após a captura, pois é o momento em que há a efetivação completa por parte do estabelecimento. Por isso há a importância da captura ser realizada para que então o fluxo da compra seja concluído.
É possível utilizar a modalidade de captura automática ou manual.
Porém é importante levar em considerações cada uma de suas características, para ter certeza se faz sentido ou não utilizar no seu negocio.
Captura Automática - como e quando utilizar
A captura automática é a mais recomendada e utilizada pela grande maioria dos estabelecimentos, pois nesse modelo não é necessário se preocupar em efetuar a confirmação da autorização, já que o gateway irá realizar a ação automaticamente no mesmo dia.
Captura Automática sempre será padrãoPor padrão, caso não seja parametrizado a solicitação de captura manual, a nossa plataforma considera o fluxo automático. Dessa forma, não será necessario que o estabelecimento se preocupe em tomar qualquer ação.
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.
Os ramos de estabelecimento que mais utilizam esse modelo são: Hoteís e Pousadas, Locadoras, Concessionárias e Lojas de eletrodomésticos.
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.
A Captura Manual deve ser solicitadaPor padrão, nossa plataforma considera a captura automatica em todas as transações. Caso queira utilizar a captura manual, deverá ser parametrizado na geração da venda.
Informações adicionais
Abaixo algumas informações importantes sobre o fluxo e detalhes a serem levados em consideração.
Diferenças entre Autorização e Captura.Principais diferenças entre uma transação autorizada e capturada:
- Enquanto uma transação está autorizada, ela não é liquidada, ou seja, as datas de repasse ao estabelecimento só começam a contabilizar após a captura.
- Uma transação autorizada pode ser cancelada, retornando assim o limite ao cartão do cliente de forma imediata, enquanto uma transação capturada necessita passar pelo processo de reembolso, onde os prazos variam de acordo o banco do portador do cartão.
Prazo máximo para Capturar uma transação.Uma autorização precisa ser capturada dentro prazo estabelecido pela adquirente/autorizada.
Em uma situação de transação não capturada, ela será automaticamente cancelada e o portador terá o limite retornado ao cartão.
Para que isso não ocorra, é importante que saiba o prazo máximo para efetuar a captura de acordo a adquirente utilizada.
Caso possua dúvidas quanto ao prazo, basta entrar em contato com o nosso suporte para auxiliá-lo.
Horários da Captura AutomáticaAs capturas ocorrem automaticamente 4 vezes ao dia, nos seguintes horários podendo atrasar no máximo 1 hora:
- 02:00 (UTC-3)
- 12:00 (UTC-3)
- 18:00 (UTC-3)
- 23:00 (UTC-3)
A autorização não é suficiente para efetivar o valor da compra na fatura do cartão. É apenas uma reserva temporária.Essa é uma dúvida recorrente por quem trabalha ou utiliza cartões de crédito em compras online.
Atualmente a grande maioria dos bancos emissores possuem aplicativos para acompanhar as compras lançadas na fatura, porém grande parte desses aplicativos não sinalizam qual o status da transação, seja autorizada ou capturada.
Consequentemente, essa falta de informação gera a dúvida se uma autorização deveria ou não aparecer no aplicativo do banco do portador já que a mesma está apenas autorizada pelo estabelecimento.
A realidade é que hoje todas as compras aparecem no aplicativo do portador, sejam de transações autorizadas ou capturadas.
Porém no fechamento da fatura, os valores a serem cobrados são apenas de compras com transações capturadas. Ou seja, se até o momento do lançamento da fatura, a transação ainda não foi capturada, ela não será parte do valor a ser pago.
Exemplo de Captura Manual
Para realizar uma transação com captura manual, basta informar na criação de venda parâmetro payments.capture com o valor "manual".
Caso a transação seja aprovada, ela terá os campos statuscomo PAID e detailed_statuscomo "AUTHORISED_TO_VALIDATE"
Exemplo de requisição e resposta.:
{
"amount": 2000,
"order_id": "BR0000-40842775",
"order_info": "charge description",
"currency": "BRL",
"type": "PAYMENT",
"soft_descriptor": "PAYTEST",
"client_ip": "174.159.112.123",
"payments": [
{
"payment_method": "card",
"amount": 2000,
"installments": 12,
"create_token": true,
"capture": "manual",
"card": {
"number": "5100010000000106",
"exp_year": 2025,
"exp_month": 12,
"cvv": "1234",
"holder_name": "Pat Mayer"
}
}
],
"customer": {
"name": "Erma Bergnaum",
"email": "[email protected]",
"phone": "551198570711",
"mobile_phone": "5511985270748",
"birth_date": "2000-01-01",
"document_type": "CPF",
"document_number": "62286843023"
}
}{
"uuid": "4d32aed2-e499-4bf1-8e20-4c2af671e13e",
"type": "PAYMENT",
"expiry_date": "2025-03-21T02:59:59Z",
"status": "PAID",
"order_id": "BR0000-40842775",
"order_info": "charge description",
"currency": "BRL",
"original_amount": 2000,
"amount": 2000,
"paid": 2000,
"due": 0,
"refunded": 0,
"attempts": 1,
"max_attempts": 5,
"drop_reason": "",
"surcharge": false,
"client_ip": "174.159.112.123",
"soft_descriptor": "PAYTEST",
"customer": {
"uuid": "58d2ea7a-edca-4cc8-9ca9-8c67dd19a1a8",
"name": "Erma Bergnaum",
"email": "[email protected]",
"birth_date": "2000-01-01",
"phone": "551198570711",
"mobile_phone": "5511985270748",
"document_type": "CPF",
"document_number": "622******23",
"created_at": "2025-03-18T14:12:36Z",
"updated_at": "2025-03-18T14:12:36Z"
},
"transactions": [
{
"uuid": "71b4fd04-961a-450c-ad14-ee45ac564d8c",
"charge_uuid": "4d32aed2-e499-4bf1-8e20-4c2af671e13e",
"gateway_id": "aed0195c8509447fafa04a335e65b038",
"amount": 2000,
"paid_amount": 2000,
"status": "PAID",
"payment_option": "CARD",
"payment_option_detail": "card",
"scheme": "MASTERCARD",
"external_id": "03060348947648721057",
"transaction_id_reference": null,
"expected_capture_date": "2025-03-18T14:12:37Z",
"payment_at": "2025-03-18T14:12:37Z",
"captured_at": null,
"auth_num": "001060",
"auth_response_code": "0",
"operation_type": "DEBIT",
"extra": null,
"payment_number": "510001XXXXXX0106",
"payer_info": "Erma Bergnaum",
"expiry_month": 12,
"expiry_year": 2025,
"acquirer_network": "REDE",
"nsu": "000582900825",
"tid": "",
"token": "fc439de6b1c04e2cba6ccead817e4695",
"create_token": true,
"detailed_status": "AUTHORISED_TO_VALIDATE",
"currency": "BRL",
"document_type": "CPF",
"document_number": "622******23",
"installments": 12,
"sub_acquirer": 1001,
"auth_3ds": null,
"created_at": "2025-03-18T14:12:38Z",
"updated_at": "2025-03-18T14:12:38Z"
}
],
"created_at": "2025-03-18T14:12:36Z",
"updated_at": "2025-03-18T14:12:36Z"
}Para realizar a captura, basta solicitar na rota referenciando o UUid da transação em /v1/transactions/{transaction_uuid}/capture
Exemplo de venda com transação capturada:
{
"uuid": "4d32aed2-e499-4bf1-8e20-4c2af671e13e",
"type": "PAYMENT",
"expiry_date": "2025-03-21T02:59:59Z",
"status": "PAID",
"order_id": "BR0000-40842775",
"order_info": "charge description",
"currency": "BRL",
"original_amount": 2000,
"amount": 2000,
"paid": 2000,
"due": 0,
"refunded": 0,
"attempts": 1,
"max_attempts": 5,
"drop_reason": "",
"surcharge": false,
"client_ip": "174.159.112.123",
"soft_descriptor": "PAYTEST",
"customer": {
"uuid": "58d2ea7a-edca-4cc8-9ca9-8c67dd19a1a8",
"name": "Erma Bergnaum",
"email": "[email protected]",
"birth_date": "2000-01-01",
"phone": "551198570711",
"mobile_phone": "5511985270748",
"document_type": "CPF",
"document_number": "622******23",
"created_at": "2025-03-18T14:12:36Z",
"updated_at": "2025-03-18T14:12:36Z"
},
"transactions": [
{
"uuid": "71b4fd04-961a-450c-ad14-ee45ac564d8c",
"charge_uuid": "4d32aed2-e499-4bf1-8e20-4c2af671e13e",
"gateway_id": "aed0195c8509447fafa04a335e65b038",
"amount": 2000,
"paid_amount": 2000,
"status": "PAID",
"payment_option": "CARD",
"payment_option_detail": "card",
"scheme": "MASTERCARD",
"external_id": "03060348947648721057",
"transaction_id_reference": null,
"expected_capture_date": "2025-03-18T14:12:37Z",
"payment_at": "2025-03-18T14:12:37Z",
"captured_at": "2025-03-18T14:52:43Z",
"auth_num": "001060",
"auth_response_code": "0",
"operation_type": "DEBIT",
"extra": null,
"payment_number": "510001XXXXXX0106",
"payer_info": "Erma Bergnaum",
"expiry_month": 12,
"expiry_year": 2025,
"acquirer_network": "REDE",
"nsu": "011867974166",
"tid": "",
"token": "fc439de6b1c04e2cba6ccead817e4695",
"create_token": true,
"detailed_status": "CAPTURED",
"currency": "BRL",
"document_type": "CPF",
"document_number": "622******23",
"installments": 12,
"sub_acquirer": 1001,
"auth_3ds": null,
"created_at": "2025-03-18T14:12:38Z",
"updated_at": "2025-03-18T14:12:38Z"
}
],
"created_at": "2025-03-18T14:12:36Z",
"updated_at": "2025-03-18T14:12:36Z"
}Exemplo de Captura Automatica
Para realizar uma transação com captura manual, basta não informar na criação de venda parâmetro payments.capture
Caso a transação seja aprovada, ela terá os campos statuscomo PAID e detailed_statuscomo "AUTHORISED"
{
"amount": 5000,
"order_id": "BR0000-31656366",
"order_info": "charge description",
"currency": "BRL",
"type": "PAYMENT",
"payments": [
{
"capture": null,
"payment_method": "card",
"amount": 5000,
"card": {
"number": "5970100300000067",
"exp_year": 2025,
"exp_month": 12,
"cvv": "1234",
"holder_name": "Suzanne Hane"
}
}
],
"customer": {
"name": "Alfonso Lesch",
"email": "[email protected]",
"phone": "5511985270748",
"birth_date": "2000-01-01",
"document_type": "CPF",
"document_number": "62286843023"
}
}{
"uuid": "61ec977e-93d7-4edb-baf7-f08dcd85f706",
"type": "PAYMENT",
"expiry_date": "2025-11-14T02:59:59Z",
"status": "PAID",
"order_id": "BR0000-31656366",
"order_info": "charge description",
"currency": "BRL",
"original_amount": 5000,
"amount": 5000,
"paid": 5000,
"due": 0,
"refunded": 0,
"attempts": 1,
"max_attempts": 5,
"drop_reason": "",
"surcharge": false,
"client_ip": null,
"soft_descriptor": null,
"enable_checkout_3ds": null,
"customer": {
"uuid": "f49c0e17-85e7-4e03-8da2-413dd21dd988",
"name": "Alfonso Lesch",
"email": "[email protected]",
"birth_date": "2000-01-01",
"phone": "5511985270748",
"mobile_phone": null,
"document_type": "CPF",
"document_number": "622******23",
"created_at": "2025-11-11T14:01:54Z",
"updated_at": "2025-11-11T14:01:54Z"
},
"transactions": [
{
"uuid": "8be8ac69-5c48-4623-bffa-4c208a3f8bf4",
"charge_uuid": "61ec977e-93d7-4edb-baf7-f08dcd85f706",
"gateway_id": "a67e175504bb447a957db7e337c56b28",
"amount": 5000,
"paid_amount": 5000,
"status": "PAID",
"payment_option": "CARD",
"payment_option_detail": "card",
"scheme": "MASTERCARD",
"external_id": "0123456789456789",
"transaction_id_reference": null,
"expected_capture_date": "2025-11-11T14:01:55Z",
"payment_at": "2025-11-11T14:01:55Z",
"captured_at": null,
"auth_num": "123456",
"auth_response_code": "0",
"operation_type": "DEBIT",
"extra": null,
"payment_number": "597010XXXXXX0067",
"payer_info": "Alfonso Lesch",
"expiry_month": 12,
"expiry_year": 2025,
"acquirer_network": "SUB",
"nsu": "654321",
"tid": "",
"token": null,
"create_token": false,
"detailed_status": "AUTHORISED",
"currency": "BRL",
"document_type": "CPF",
"document_number": "622******23",
"installments": 1,
"sub_acquirer": 1002,
"has_auth_3ds": false,
"created_at": "2025-11-11T14:01:56Z",
"updated_at": "2025-11-11T14:01:56Z"
}
],
"created_at": "2025-11-11T14:01:54Z",
"updated_at": "2025-11-11T14:01:54Z"
}