Flag de Recorrência

Por padrão, o módulo PagBank/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 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 é 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 é 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.

Instalação

Recomendamos a instalação manual do módulo 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.

{  
  "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:

SELECT public_hash FROM seu_db.vault_payment_token where customer_id = 2;