---
updatedAt: 2025-10-31T16:37:24.000Z
agentTools:
  projectIndex: https://dev.iugu.com/llms.txt
---

# Cobrança em Duas Etapas (Captura Tardia)

> 📘 O que você irá aprender com esse artigo?
>
> * O que é cobrança em duas etapas
> * Como habilitar cobrança em duas etapas na iugu
> * Como realizar a captura ou cancelamento da fatura via AP

**Caso de uso**

*“Vendedor possui um sistema de serviços, onde o cliente acessa o aplicativo e solicita um montador de móveis. O vendedor precisa garantir que o cliente terá saldo para pagar o serviço antes de deslocar o profissional que fará a montagem, mas ele deseja capturar o valor a ser pago apenas após a prestação do serviço, como garantia de que o trabalho foi feito.”*

**Diagrama de sequência**

![](https://files.readme.io/967f303-Untitled.png "Untitled.png")

# O que é uma cobrança em duas etapas (captura tardia)

A cobrança em duas etapas é uma **pré-autorização** do valor de uma transação no cartão de crédito do comprador. Ou seja, basicamente é uma **reserva desse valor no cartão** que pode ser **capturada** ou **cancelada** após algumas horas ou após dias.

A cobrança em duas etapas, como o próprio nome diz, ocorre em duas sequencias de passos: a autorização e a captura.

A **autorização** ocorre quando as adquirentes vinculadas à iugu validam o cartão e verificam se há algum problema de limite, data de validade, dígitos do cartão, entre outros. Se estiver tudo certo a autorização é realizada com sucesso e nesse momento o valor é reservado no cartão do comprador. Nesse cenário, a fatura fica com status “Em análise".

A segunda etapa é a **captura**, onde o valor será capturado de fato, dessa forma, ele é debitado do cartão do cliente final. É possível também, ao invés de escolher a captura do valor, escolher o **cancelamento** da reserva.

Em todo caso, se em **7 dias** corridos nenhuma das duas ações forem tomadas, o **cancelamento será feito de forma automática** pela iugu.

# Como habilitar cobrança em duas etapas na iugu

Para habilitar este recurso é necessário acessar o painel da conta iugu e clicar em: **Configurações > Cartão de Crédito > Fluxo de Pagamento em duas etapas**.

# Como realizar a captura ou cancelamento da autorização via API

Com o passo anterior, as faturas já estarão habilitadas para a cobrança em duas etapas. Então depois de ter a fatura criada e autorizada, o passo seguinte é a captura ou cancelamento dessa autorização.

Para melhor controle das faturas que precisam ser capturadas ou canceladas é recomendado o uso de gatilhos para verificar o status da transação. Nesse caso, crie um gatilho para o evento de **invoice.status\_changed**.

Os gatilhos podem ser configurados pelo painel da conta, veja como fazer [aqui](https://dev.iugu.com/docs/gatilhos). Para realizar a configuração via API é necessário realizar um POST na API de [Criar Gatilho](https://dev.iugu.com/reference#criar-gatilho).

**Modelo de request**

```curl
curl --location --request POST 'https://api.iugu.com/v1/web_hooks' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic {{api_token in base64}}' \
--header 'Cookie: __cfruid=c225e22a406e3690b6b1b472c244bd81423884f6-1633892271' \ 
--data-raw '{ 
    "event": "invoice.status_changed", 
    "url": "https://webhook.site/3e9fb0cc-523a-49f8-8acc-c2485d0954ac", 
    "authorization": "my_key" 
}'
```

**Modelo de response:**

![](https://files.readme.io/74cc28d-Criar_gatilho.png "Criar_gatilho.png")

O primeiro passo é criar o comprador com seus respectivos dados, conforme a API de [Criar cliente](https://dev.iugu.com/reference/criar-cliente). Depois é necessário tokenizar o cartão, se tiver PCI é só criar o token na API de [Criar Token](https://dev.iugu.com/reference/criar-token) e se não tiver é necessário utilizar o [iugu.js](https://dev.iugu.com/docs/iugu-js). Para mais detalhes do iugu.js veja esse [artigo](https://dev.iugu.com/docs/tokeniza%C3%A7%C3%A3o). Caso seja necessário armazenar os dados do cartão para compras futuras, utilize a API de [Criar Forma de Pagamento](https://dev.iugu.com/reference/criar-forma-de-pagamento).

Com os dados do cliente é possível criar uma fatura que terá seu valor reservado.

Para isso é necessário realizar um POST na API de [Criar Fatura](https://dev.iugu.com/reference/criar-fatura).

**Modelo de request**

```curl
curl --location --request POST 'https://api.iugu.com/v1/invoices' \ 
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic {{api_token in base64}}' \
--header 'Cookie: __cfruid=c225e22a406e3690b6b1b472c244bd81423884f6-1633892271' \ 
--data-raw '{ 
    "email": "cliente_iugu@mailinator.com", 
    "due_date": "2021-10-10", 
    "ensure_workday_due_date": false, 
    "items": [ 
        { 
            "description": "Item teste", 
            "quantity": 1, 
            "price_cents": 1000 
        } 
    ], 
    "fines": false, 
    "late_payment_fine": 2, 
    "per_day_interest": false, 
    "per_day_interest_value": 5, 
    "payable_with": [ 
        "all" 
    ], 
    "customer_id": "844E3AB785AD4A78877CB2639DE4BAA3", 
    "order_id": "1633897104" 
}'
```

**Modelo de response**

![](https://files.readme.io/10c0545-fatura2.png "fatura2.png")

# Autorizar a fatura

No retorno da criação da fatura pegue o id que foi retornado, que identifica essa fatura, para criar a autorização. Para autorizar a fatura, ou criar a reserva, faça um POST na API de [Cobrança Direta](https://dev.iugu.com/reference/cobranca-direta).

**Modelo de request**

```curl
curl --location --request POST 'https://api.iugu.com/v1/charge' \ 
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic {{api_token in base64}}' \
--header 'Cookie: __cfruid=c225e22a406e3690b6b1b472c244bd81423884f6-1633892271' \ 
--data-raw '{ 
    "customer_payment_method_id": "FDEB80CC57EA4BA1ADE6C7119CB702CD", 
    "invoice_id": "892CFB1F859940669B62BA0A433B5F10" 
}'
```

**Modelo de response**

![](https://files.readme.io/b23a54f-fatura2_autorizada.png "fatura2_autorizada.png")

No momento da autorização da fatura será disparado um gatilho do **invoice.status\_changed** informando o status da fatura como ***"in\_analysis”***. Essa notificação mostrará que a fatura se encontra em análise, ou seja, a reserva foi criada e ainda falta capturar o pagamento.

**Modelo de gatilho**

![](https://files.readme.io/c417137-gatilho_fatura.png "gatilho_fatura.png")

Até esse ponto há um valor reservado no cartão do cliente, ou seja, ele não pode usar o limite desse valor que foi gerado para outros pagamentos, pois ele está bloqueado. Mas esse valor ainda não foi debitado da conta dele, então o vendedor ainda não recebeu esse pagamento. Para isso, é necessário que seja feita uma captura dessa autorização ou que a reserva seja cancelada, se for o caso.

## Capturar autorização

Depois de reservar aquele valor o passo seguinte é capturar a autorização. Nesse caso, envie o id da fatura que foi obtido através do gatilho ou que foi retornado na criação da fatura e faça um **POST** na API de [Capturar fatura](https://dev.iugu.com/reference/capturar-fatura).

**Modelo de request**

```curl
curl --location --request POST 'https://api.iugu.com/v1/invoices/{{invoice_id}}/capture' \ 
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic {{api_token in base64}}' \
--header 'Cookie: __cfruid=c225e22a406e3690b6b1b472c244bd81423884f6-1633892271'
```

**Modelo de response**

![](https://files.readme.io/881cdc1-capturar_fatura2.png "capturar_fatura2.png")

Assim que a fatura for capturada, uma nova notificação será disparada avisando que a fatura teve seu status alterado para pago.

![](https://files.readme.io/77044a2-gatilho_fatura2_paga.png "gatilho_fatura2_paga.png")

## Cancelar autorização

Para cancelar a reserva basta informar o id da fatura que foi obtido através do gatilho ou que foi retornado na criação da fatura. Nesse caso é feito um **PUT** na API de [Cancelar Fatura](https://dev.iugu.com/reference/cancelar).

**Modelo de request**

```curl
curl --location --request PUT 'https://api.iugu.com/v1/invoices/{{invoice_id}}/cancel' \ 
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic {{api_token in base64}}' \
--header 'Cookie: __cfruid=c225e22a406e3690b6b1b472c244bd81423884f6-1633892271'
```

**Modelo de response**

![](https://files.readme.io/f34f539-cancelar_reserva.png "cancelar_reserva.png")

Assim que a fatura for cancelada, uma nova notificação será disparada avisando que a fatura teve seu status alterado para cancelado.

**Modelo de gatilho**

![](https://files.readme.io/313d51a-fatura_cancelada.png "fatura_cancelada.png")