Pular para o conteúdo
Todos os artigos

Fallback e recorrência

Por que adicionar um provedor não move os cartões salvos

Roteamento de novas cobranças, renovação e migração de instrumentos são problemas diferentes.

Infi4 min de leitura

Você conecta um segundo provedor. Testa uma compra nova. O pagamento funciona.

Na renovação seguinte, as assinaturas existentes continuam usando o primeiro.

Parece que o roteamento ignorou a configuração. Mas a cobrança nova e a renovação não começaram do mesmo lugar.

Na primeira, o cliente estava presente para fornecer um meio de pagamento. Na segunda, o sistema precisava usar um instrumento que já havia sido salvo.

O identificador não é o cartão

Um token ou uma referência de instrumento não deve ser tratado como um objeto universal que qualquer processador consegue cobrar.

Ele existe dentro de um contexto: provedor, conta e processo pelo qual foi criado. Copiar seu identificador para outra integração não transfere os dados ou a autorização necessários para executá-lo.

Isso importa especialmente numa cobrança off-session, realizada sem o cliente interagindo naquele momento.

No desenho atual da Infi, o instrumento salvo permanece associado ao seu provedor. A renovação que o utiliza não passa a escolher livremente qualquer processador conectado.

A abstração da API mantém um contrato consistente para a aplicação. Ela não elimina a origem nem as restrições do instrumento.

Há três mudanças diferentes nessa conversa

A primeira é escolher o provedor de uma nova compra. O cliente pode interagir com o fluxo suportado e fornecer o meio de pagamento necessário.

A segunda é recuperar uma cobrança usando um instrumento existente. A execução precisa respeitar a conta, o provedor e as condições daquele instrumento.

A terceira é migrar a base. Isso envolve procedimentos específicos, correspondência de registros e validação de quais dados podem ser transferidos. Não acontece como efeito colateral de ativar uma integração.

A Stripe, por exemplo, documenta uma transferência segura coordenada com o novo processador. O mesmo guia distingue os dados de cartão de objetos como assinaturas e histórico de pagamentos, que não fazem parte daquela exportação. Procedimento documentado de migração.

Misturar as três transforma uma expectativa comercial simples — “quero usar outro provedor” — num compromisso técnico que ninguém chegou a avaliar.

Uma troca gradual pode ser mais clara

Considere um plano ilustrativo de adoção: novas compras começam num fluxo validado, enquanto a base existente continua usando os instrumentos que já possui.

A empresa acompanha os dois grupos e decide separadamente como tratar clientes antigos. Dependendo do fluxo e das condições dos provedores, isso pode exigir uma migração coordenada ou uma nova coleta autorizada do meio de pagamento.

Não é uma recomendação para exportar dados de cartão por conta própria. Dados sensíveis e credenciais devem permanecer nos procedimentos seguros oferecidos pelos serviços envolvidos.

Também não basta mover o instrumento e esquecer a assinatura. A operação precisa preservar a identidade do cliente, o vínculo com a fatura e o histórico de tentativas.

O fallback precisa conhecer essa restrição

Se um instrumento só pode ser usado por um provedor, uma lista com cinco candidatos não cria cinco opções reais.

Uma falha pode exigir esperar uma nova tentativa permitida, solicitar uma ação do cliente ou disponibilizar outra forma de pagamento. Essas alternativas dependem do motivo e do fluxo; não devem virar um redirecionamento cego de cobranças.

Ao testar recorrência, inclua um instrumento salvo antes de adicionar o segundo provedor. Faça o teste falhar de maneira controlada e confira o comportamento esperado.

Uma demo só com compras novas não valida a recuperação da carteira existente.

O contrato estável não promete portabilidade automática

Adotar a Infi pode preservar Stripe ou outro provedor como parte da infraestrutura e abrir espaço para novas rotas compatíveis. O objetivo é organizar essa liberdade sem espalhar cada integração pela aplicação. Infi Routing.

Cartões salvos continuam exigindo um plano próprio.

Uma configuração de roteamento responde quem pode executar determinada cobrança. Uma migração responde como levar uma operação existente para outro contexto.

Dar nomes diferentes a esses trabalhos evita prometer ao negócio que uma mudança de rota também transporta todo o passado.