Alterar a forma de pagamento da assinatura
Troca o cartão de crédito usado nas próximas cobranças da assinatura.
O endpoint aceita somente cartão já tokenizado: os dados do cartão nunca passam pelo seu servidor. São dois passos:
- No navegador do assinante, o Appmax JS
recebe os dados do cartão e devolve um
tokenno callbackonSuccess. Esse passo exige oexternal-idda instalação do app na loja. - No seu backend, chame este endpoint enviando esse
token.
A bandeira e os quatro últimos dígitos são derivados do próprio token — não precisa (nem deve) enviá-los.
Esta rota exige a permissão `subscription-payment-method`
Diferente das outras rotas de assinatura, a credencial precisa carregar
a permissão subscription-payment-method. Sem ela a chamada é recusada
pelo gateway com 403. Fale com o time da Appmax para habilitá-la na
credencial da sua loja. Veja Autenticação.
WARNING
O token precisa ter sido gerado pela mesma loja da assinatura, e a loja
precisa usar o mesmo meio de captura em que o token foi criado. Caso
contrário a resposta é 400.
Se a assinatura estiver overdue ou suspended, a cobrança em aberto é
reprocessada na hora com o cartão novo. Aprovando, a assinatura volta
para active e a próxima cobrança é reagendada — a resposta já traz o
status atualizado.
TIP
Neste momento o endpoint troca apenas entre cartões de crédito. Uma assinatura em PIX passa a ser cobrada no cartão informado.
Autorizações
Token Bearer do merchant obtido via POST /oauth2/token usando as
credenciais do merchant (não do app). Veja
Autenticação.
Parâmetros
Parâmetros de Caminho
Identificador da assinatura.
10Corpo da Requisição
Respostas
Forma de pagamento atualizada. Retorna o detalhe atualizado da
assinatura, já com a nova bandeira e os novos quatro últimos
dígitos em payment.payment_info.