---
updatedAt: 2026-08-26T16:55:06.000Z
agentTools:
  projectIndex: https://developer.pagbank.com.br/llms.txt
---

# Flag de Recorrência

Por padrão, o módulo [PagBank/Payment-Magento ](https://github.com/pagseguro/payment-magento) não suporta pagamentos recorrentes. No entanto, você pode utilizar uma extensão para adicionar uma flag que permite que sejam aceitos pagamentos recorrentes.

A aceitação de pagamentos recorrentes ocorre através da ativação da Flag de Recorrência. Você pode utilizar o módulo [PagBank Flag Recurring Magento](https://github.com/elisei/pagbank-flag-recurring-magento) como ponto de partida dessa configuração. Esse é um módulo gratuito que insere o recurso de recorrência aos pagamentos feitos. No entanto, é importante ressaltar que essa extensão não gera o motor de recorrência. Ela apenas implementa a ação necessária para que o PagBank identifique o pagamento como recorrente.

A lógica de definição para o fluxo de pagamento do módulo [PagBank Flag Recurring Magento](https://github.com/elisei/pagbank-flag-recurring-magento) é realizada por meio de configuração administrativa, implementada no arquivo `Model/FlagRecurringConfigProvider.php`. Para a utilização em produção, é recomendado alterar a lógica para captura dessa informação, possivelmente baseada nos produtos do carrinho.

## Ressalvas e advertências de uso

O [PagBank Flag Recurring Magento](https://github.com/elisei/pagbank-flag-recurring-magento) é uma extensão do módulo oficial da empresa PagBank.

> 📘 Suporte
>
> Em caso de dúvidas e problemas com a extensão, abra um chamado no nosso [formulário de suporte](https://app.pipefy.com/public/form/sBlh9Nq6).

## Instalação

Recomendamos a instalação manual do módulo [PagBank Flag Recurring Magento](https://github.com/elisei/pagbank-flag-recurring-magento). Isso é recomendado, pois uma vez em produção, você possivelmente precisará alterar a lógica de definição da flag de recorrência.

## Orientação para a construção de um motor de recorrência

Para novos ciclos de pagamento para recorrência você deverá realizar o pagamento utilizando o vault salvo no processo inicial e alterar a flag para `SUBSEQUENT`. Abaixo você encontra um exemplo de request. Esse request deve ser enviado utilizando o método POST para `{{base_url}}/rest/V1/carts/mine/payment-information`.

```json
{  
  "billing_address": {  
    "region": "São Paulo",  
    "region_id": 508,  
    "region_code": "SP",  
    "country_id": "BR",  
    "street": [  
      "Rua Aleatória",  
      "22",  
      "Bairro"  
    ],  
    "telephone": "34984427885",  
    "postcode": "38017-190",  
    "city": "São Paulo",  
    "firstname": "Bruno",  
    "lastname": "Elisei",  
    "email": "[brunoelisei@o2ti.com](mailto:brunoelisei@o2ti.com)"  
  },  
  "paymentMethod": {  
    "method": "pagbank_paymentmagento_cc_vault",  
    "additional_data": {  
      "cc_installments": 1,  
      "public_hash": "{{vault_public_hash}}",  
      "payer_name": "Bruno Elisei",  
      "payer_tax_id": "1234567890",  
      "payer_phone": "34984427885",  
      "recurring_type": "SUBSEQUENT"  
    }  
  }  
}
```

Note que no exemplo acima `paymentMethod.recurring_type` é definido como `SUBSEQUENT`. Além disso,  `vault_public_hash` é o valor público do cartão salvo, obtido utilizando:

```sql
SELECT public_hash FROM seu_db.vault_payment_token where customer_id = 2;
```