Skip to main content

Troca de Cartão

Este fluxo descreve a troca do cartão de crédito utilizado para cobrança em um contrato. A requisição é enviada pelo nosso sistema para a API do parceiro contendo os dados do novo cartão.
Nenhum webhook de retorno é necessário — o parceiro apenas processa internamente.

🔁 Visão Geral do Fluxo​

  1. Nosso sistema envia a requisição UPDATE_CARD com os dados do novo cartão.
  2. A API do parceiro atualiza as informações e armazena o novo cartão como padrão.

📤 Requisição enviada pelo nosso sistema (para o parceiro)​

Endpoint (API do parceiro): definido pelo parceiro.

Payload:

{
  "contract_id": 1002,
  "partner_pay_subscription_id": 2002,
  "event": "UPDATE_CARD",
  "data": {
    "card": {
      "holder": "João da Silva",
      "brand": "Visa",
      "number": "4111111111111111",
      "cvv": "123",
      "is_default": "true",
      "exp_date": "08/27"
    }
  }
}

✅ Regras da solicitação​

  • Os dados do cartão devem estar completos e válidos.
  • O campo is_default define se o novo cartão será o principal para futuras cobranças.
  • A data de expiração (exp_date) deve estar no formato MM/YY.

📥 Webhook de retorno​

Nenhum webhook de retorno é esperado neste fluxo.

📋 Exemplo do fluxo completo​

🧪 Considerações técnicas​

  • O parceiro deve validar e armazenar o cartão com segurança.
  • O número do cartão pode ser tokenizado do lado do parceiro.

🔄 Resposta esperada da API do parceiro​

{
  "success": true
}