Alterar o dia de cobrança
Altera o dia fixo de cobrança da assinatura. A mudança vale para todos os
ciclos futuros e a próxima data de cobrança (next_charge_at) é
recalculada.
Dias 29, 30 e 31 são aceitos: nos meses que não têm o dia escolhido a cobrança cai no último dia do mês, e o dia volta a valer no mês seguinte que o tiver. Uma assinatura no dia 31 cobra 31/01, 28/02, 31/03, 30/04.
Quando o novo dia passa a valer
A periodicidade da assinatura não muda — só o dia. A partir daí:
- o dia ainda vai ocorrer neste mês → vale já na próxima cobrança;
- o dia já passou neste mês → vale na próxima vez que ele ocorrer, ainda que isso desloque os meses da assinatura (uma bimestral de set/nov passa a cobrar em out/dez). Um mês de espera em vez de um ciclo inteiro;
- a data ficaria a menos de meio ciclo da última cobrança → o novo dia vale a partir do ciclo seguinte, para que ninguém seja cobrado duas vezes por causa de um ajuste de calendário.
Nos dois últimos casos a resposta vem com adjusted: true e o motivo em
adjusted_reason / adjusted_message, para você saber por que a data entregue
não é a que o dia escolhido produziria.
Assinaturas com periodicidade em dias (interval: day) não têm dia fixo de
cobrança: cada cobrança acontece N dias depois da anterior. Nelas a alteração é
recusada com 422.
Ciclos já pagos adiantado por antecipação de cobrança e ciclos pulados são preservados: o novo dia é aplicado ao ciclo que já estava agendado. Quem antecipou dois ciclos continua com a próxima cobrança dois ciclos à frente, agora no dia escolhido.
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
Dia de cobrança atualizado.