Pular para o conteúdo principal

Trocar o cartão

PUT/api/v1/subscriptions/:id/card

Aceita as mesmas três formas da seção Criar assinatura com cartão — uma delas, sozinha:

{ "encryptedCardData": "base64_da_criptografia_RSA..." }
{ "sourceSubscriptionId": 12 }
{
  "cardNumber": "5500000000000004",
  "cvv": "456",
  "expirationDate": "06/2029",
  "cardHolder": "MARIA OLIVEIRA"
}

O novo cartão passa a valer para as próximas cobranças — inclusive uma retentativa já agendada (Retentativa de cobrança negada). A troca não dispara cobrança na hora.

SituaçãoResposta
Troca feita200 com a assinatura
Assinatura não ACTIVE409. Em PENDING_PAYMENT o cartão entra pelo checkout (Criar assinatura sem cartão/Ativar a assinatura pelo seu próprio checkout)
Cartão inválido, vencido ou com validade inválida400 com as mensagens da seção Criar assinatura com cartão. O cartão anterior continua valendo
Cartão recusado na tokenização422 CARD_REJECTED. O cartão anterior continua valendo
sourceSubscriptionId de outro pagador409 Source subscription belongs to a different payer — mesmas regras da seção Criar assinatura com cartão
sourceSubscriptionId igual à própria assinatura400