[API v4] Visa e Elo | Identificador de recorrência para assinaturas externas

Introdução

A implementação de assinaturas externas tem como objetivo melhorar a gestão de transações recorrentes, assegurando que o identificador da primeira cobrança seja utilizado em todas as cobranças subsequentes.

Essa prática, exigida pelas bandeiras Visa e Elo, visa trazer mais controle, transparência e conformidade às transações de assinaturas, além de evitar multas por não atender às novas regulamentações.

O prazo para adequação é até 30 de setembro de 2024.

Novo Campo: Facilitando a Identificação das Transações

Para garantir que todas as transações de assinaturas externas sejam corretamente vinculadas à transação original, foi criado um novo campo que estará disponível na rota POST /transactions:

• brand_transaction_id: Identificador da bandeira referente a primeira transação da assinatura externa.

Esse campo precisa ser incluído em todas as transações subsequentes para garantir a identificação correta de uma assinatura externa.

Fluxo de assinaturas externas

1. Primeira Transação (Criação da Transação): Quando você realiza a criação de uma transação para iniciar uma assinatura externa, a primeira transação é registrada, gerando o brand_transaction_id correspondente. Caso a assinatura seja uma migração de outro sistema, a informação de brand_transaction_id já deve ser enviada na primeira transação.
   1. Cada bandeira pode retornar um padrão de brand_transaction_id. Exemplos:
      1. Mastercard: BUQY9X (Alfanumérico)
      2. Visa: 384269516450059 (Numérico)
      3. Elo: 2692422A0574101 (Alfanumérico)
      4. Hiper: GHZR9W (Alfanumérico)
2. Transações Subsequentes: Para todas as cobranças futuras da assinatura, é obrigatório incluir o brand_transaction_id. Esse campo garante o correto rastreamento e vínculo com a transação original, conforme exigido pelas bandeiras.

Com esse novo campo, o fluxo de assinaturas externas se torna mais eficiente e em conformidade com os requisitos regulatórios, oferecendo mais controle e transparência nas transações.

Alterações na Recorrência

Caso ocorra alguma alteração na recorrência, como mudança de cartão (seja com a mesma bandeira ou com bandeiras diferentes), alteração de meio de pagamento ou alteração de valores, o ID da primeira transação após a alteração deverá ser considerado como o novo primeiro, passando a ser o ID enviado.

Para clientes que utilizam o produto Card Updater (Bandeira Visa) para a atualização de cartões vencidos, não é necessário alterar o ID enviado, uma vez que essa alteração é comunicada diretamente com a bandeira Visa. Para usar esse produto é necessário integrar com a V5 de nossa API.

Exemplo de Request para Criação de Pedido:

{
  "api_key": "SUA_API_KEY",
  "amount": 21000,
  "card_number": "4111111111111111",
  "card_cvv": "123",
  "card_expiration_date": "0830",
  "card_holder_name": "Morpheus Fishburne",
  "customer": {
    "external_id": "#3311",
    "name": "Morpheus Fishburne",
    "type": "individual",
    "country": "br",
    "email": "[email protected]",
    "documents": [
      {
        "type": "cpf",
        "number": "30621143049"
      }
    ],
    "phone_numbers": [
      "+5511999998888",
      "+5511888889999"
    ],
    "birthday": "1965-01-01"
  },
  "brand_transaction_id": "12321321244" ## NEW Tamanho: até 35 caracteres/ Alfanumérico
}

{
   "acquirer_id"= "5969170917bce0470c8bf099",
    "acquirer_name" = "pagarme",
    "acquirer_response_code" = "0000",
    "acquirer_response_message"="Transação aprovada com sucesso",
    "amount"= "181500",
    "authorization_code"="642644",
    "authorized_amount"="181500",
    "brand_transaction_id"="58426987881149",
    "capture_method"= "ecommerce",
    "card_brand"= "visa",
    "card_first_digits"="4411111"
    "card_funding_source"="credit"
    "card_holder_name"="Morpheus Fishburne"
    "card_last_digits"="1111"
    "card_magstripe_fallback"="false"
    "cost"="0" ...
    }

📘

Assinaturas Internas

Se você utiliza o motor de recorrência do Pagar.me, não é necessário se preocupar com o envio manual dessas informações.

O sistema cuidará automaticamente de transmitir os identificadores necessários, garantindo que todas as transações sejam processadas corretamente.

📘

Assinaturas Externas

Se você não utiliza o motor de recorrência do Pagar.me e que trabalha com mais de um meio de pagamento ou mais de um cartão na mesma assinatura deve considerar cada meio de pagamento ou cartão como uma transação separada. Portanto, é necessário o envio do ID correspondente a cada uma delas.

Conclusão

Essa implementação é crucial para garantir que as assinaturas externas sejam identificadas de forma precisa e estejam em conformidade com os requisitos das bandeiras. Adequar-se a essas mudanças garante que cada transação subsequente de uma assinatura tenha uma referência clara à primeira cobrança, facilitando o monitoramento e evitando penalidades.

Em caso de dúvidas, entre em contato com nosso time de atendimento ao cliente pelo e-mail [email protected], pelo chat na sua dashboard ou pelo telefone 4004-1330.