Trocar cartão da assinatura
Substitui o cartão de crédito usado nas cobranças de uma assinatura paga com cartão. O novo cartão é salvo no gateway e passa a ser cobrado a partir do próximo ciclo; o plano, o valor e as datas de cobrança não mudam.
A troca é aceita em qualquer situação da assinatura — use-a, por exemplo, para regularizar uma
assinatura cuja renovação foi recusada. Se o gateway não aceitar a troca naquele estado, a
requisição retorna 400 com a mensagem do gateway.
A troca não gera cobrança, por isso não exige Idempotency-Key. Conta no limite por minuto
da credencial, como qualquer rota.
Sem campo de autorização: o portal autentica por você com a sua chave de Homologação e as requisições rodam só no ambiente de testes.
Token de acesso devolvido por POST /auth/token. Envie como "Authorization: Bearer ". Vale 24 horas.
In: header
Path Parameters
uuidDados do cartão de crédito usado na cobrança.
Response Body
curl -X PATCH "https://pagpolar-api.creativecode.dev.br/v1/subscriptions/497f6eca-6276-4993-bfeb-53cbbbba6f08/card" \ -H "Content-Type: application/json" \ -d '{ "credit_card": { "holder_name": "FULANO DE TAL", "holder_document": "12345678909", "number": "4111111111111111", "expiration_month": 12, "expiration_year": 2030, "cvv": "123" } }'{
"data": {
"success": true
}
}{
"error": {
"code": "invalid_request",
"message": "string",
"request_id": "string"
}
}{
"error": {
"code": "invalid_request",
"message": "string",
"request_id": "string"
}
}{
"error": {
"code": "invalid_request",
"message": "string",
"request_id": "string"
}
}{
"error": {
"code": "invalid_request",
"message": "string",
"request_id": "string"
}
}{
"error": {
"code": "invalid_request",
"message": "string",
"request_id": "string"
}
}{
"error": {
"code": "invalid_request",
"message": "string",
"request_id": "string"
}
}