Saved payment methods

Onde no portal: Billing › Settings (/billing?settings=1). Onde no admin: Customers › List › a customer › Overview (/customers/<id>), cartão Payment, mostra o método salvo e o histórico de recarga automática.

O que faz

Um método de pagamento salvo permite que o NexCMP faça cobranças de um cliente sem a presença dele, para que seus serviços nunca parem porque a carteira esvaziou. Ele é usado apenas pela automatic top-up. Existem dois tipos: um cartão salvo na Stripe (incluindo cartões usados via Apple Pay, Google Pay ou Link quando a Stripe retorna um cartão reutilizável) e uma conta PayPal armazenada no cofre do PayPal.

Requisitos

Item	Requisito
Canais	Stripe e/ou PayPal configurados e ativados.
Site	O site principal ou um site de revendedor cujo canal de pagamento é coletado pela plataforma. Um site de revendedor que usa sua própria conta Stripe não pode salvar cartões.
Cliente	Uma conta de cliente que fez uma recarga com o cartão ou PayPal.

Como um método é salvo

1. O cliente abre Billing, clica em Deposit e paga com Card ou PayPal.
2. O pagamento é criado para que o método possa ser reutilizado posteriormente: a Stripe armazena o cartão junto ao cliente na Stripe (uso fora de sessão), o PayPal armazena um token de cofre. O NexCMP mantém apenas referências (um ID de método de pagamento e ID de cliente da Stripe, ou o ID do cofre do PayPal) e um rótulo de exibição como visa •••• 4242 ou o e-mail do PayPal. Os números dos cartões nunca tocam no seu servidor.
3. Quando o pagamento é concluído, a automatic top-up é ativada uma única vez se o cliente nunca tiver escolhido configurações antes. Não há nenhuma caixa de seleção ou mensagem extra na tela. O servidor registra a hora, o endereço IP do cliente e o método como evidência.
4. Na próxima vez, a tela de depósito oferece Saved card ... no menu suspenso de cartões e Saved PayPal ... para o PayPal.

Gerenciar e remover

1. No portal, vá para Billing e clique em Settings. O painel mostra os métodos salvos (cartão Stripe e/ou PayPal) e as opções de recarga automática.
2. Para remover um cartão, clique em Remove card e confirme. O Stripe desvincula o cartão e o auto top-up é desativado.
3. Para remover o PayPal, clique em Remove saved PayPal e confirme.

Visão do administrador

Abra o cliente em Customers › List. O cartão Payment na aba Overview exibe os rótulos dos métodos salvos (Saved cards), o gateway usado para cobranças automáticas, o registro de consentimento armazenado (hora, IP, método) e as últimas 20 tentativas de cobrança automática com seus status e motivos (Auto top-up history).

Verificar

1. Como cliente de teste, deposite o valor mínimo usando o cartão. Após a conclusão do pagamento, abra Billing › Settings: o cartão e a chave de auto top-up (ligada) estarão visíveis.
2. Inicie outro depósito: o menu suspenso oferece o cartão salvo.
3. No painel administrativo, o cartão Payment do cliente exibe o mesmo rótulo do cartão.

Limites e notas

• Stripe Link e carteiras. Link, Apple Pay e Google Pay são recursos do Stripe. O NexCMP não armazena nada específico do Link; ele apenas mantém a referência do cartão retornada pelo Stripe.
• PayPal. Cada recarga do PayPal iniciada pelo cliente requer um clique; o PayPal salvo é usado apenas pelo auto top-up, nunca por outros recursos.
• Sites de revendedores. Se um revendedor usar sua própria conta do Stripe ou PayPal, os métodos salvos ficam ocultos e o auto top-up fica indisponível para esse site.
• Disputas. Uma disputa em qualquer pagamento bloqueia a conta e interrompe seus serviços pré-pagos; consulte Stripe.
• Remover o último método desativa o auto top-up; o cliente mantém o saldo da carteira.
• Evidência. O registro de consentimento é gravado pelo servidor (não editável pelo cliente) e é mantido para o tratamento de disputas.

Resolução de problemas

Sintoma	Causa	Correção
O cliente não vê o botão de configurações nem o cartão salvo	O site usa um canal de pagamento pertencente ao revendedor ou ainda não há pagamento com cartão	Faça uma recarga por cartão ou PayPal através do canal da plataforma.
"Saved card" ausente após um pagamento via Stripe	O pagamento foi feito com um método que não pode ser reutilizado (por exemplo, Alipay)	Pague novamente usando um cartão.
PayPal: "ainda não é possível salvar esta conta"	O PayPal não retornou um token de cofre (vault token)	Continue com um pagamento único ou tente outra conta do PayPal.
O auto top-up parou após a remoção do cartão	Esperado: remover o cartão desativa o recurso	Salve um novo método no próximo depósito.