Skip to main content
POST
Atualizar método de pagamento
Troca o método de pagamento padrão da assinatura. Use quando o cliente muda o cartão ou passa a pagar com PIX. Funciona em TRIAL, PENDING, ACTIVE ou PAST_DUE. Envie payment_methods com type: credit_card ou type: pix. Em PIX, não envie dados de cartão. pix_type aceita immediate (padrão) ou automatic. Se a assinatura estiver PAST_DUE e existir fatura open:
  • Cartão: inicia uma nova cobrança dessa fatura. A fatura continua open. A assinatura continua PAST_DUE.
  • pix_type: immediate: inicia uma nova cobrança dessa fatura. A resposta traz pix.qrcode como null. A fatura continua open. A assinatura continua PAST_DUE.
  • pix_type: automatic: cria o Pix Automático e devolve pix.qrcode. A fatura continua open. A assinatura continua PAST_DUE.
Nos outros status, só o método padrão muda. A próxima cobrança segue o ciclo da fatura. ATENÇÃO: envie dados de cartão só do seu backend. Erros comuns: 400 (payload inválido), 401/403 (credenciais ou produto Recorrência), 404 (não encontrada), 409 (método não permitido no plano), 422 (status não permite a troca).

Authorizations

client-id
string
header
required
client-secret
string
header
required

Headers

client-id
string
required

ID público da credencial do merchant

client-secret
string
required

Secret da credencial do merchant

Path Parameters

subscriptionId
string<uuid>
required

Body

application/json
payment_methods
object
required

Novo método de pagamento (credit_card ou pix) a definir como padrão.

Response

Método atualizado

subscription_id
string<uuid>

Identificador da assinatura.

payment_method
object

Novo método de pagamento padrão.