Skip to main content
PUT
/
v1
/
subscriptions
/
change-card
/
{subscription_code}
Alterar cartão da assinatura
curl --request PUT \
  --url https://hml.4seletpay.com.br/api/v1/subscriptions/change-card/{subscription_code} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'account: <account>' \
  --data '
{
  "name": "CARLOS FERREIRA",
  "number": "5500000000000004",
  "month": "09",
  "year": "29",
  "security_code": "789"
}
'
{
  "mensagem": "Cartão alterado com sucesso",
  "erro": false,
  "mensagenserro": [],
  "codigoretorno": 200,
  "id": "00000000-0000-0000-0000-000000000000",
  "data": {
    "card_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  }
}
Requer o header account. A assinatura precisa estar em status Recurring para alterar o cartão. Um novo cartão é criado e vinculado à assinatura para as próximas cobranças.
A resposta inclui o card_id do novo cartão criado no campo data.

Authorizations

​
Authorization
string
header
required

Token JWT obtido via POST /v1/login. Envie no header Authorization: Bearer <token>.

Headers

​
account
string
required

Código da conta à qual a operação se aplica

Example:

"acc_abc123xyz"

Path Parameters

​
subscription_code
string
required

Código único da assinatura

Example:

"sub_abc123"

Body

application/json
​
name
string
required

Nome do titular do cartão (obrigatório)

Example:

"CARLOS FERREIRA"

​
number
string
required

Número do cartão (obrigatório)

Example:

"5500000000000004"

​
month
string
required

Mês de validade do cartão (obrigatório)

Example:

"09"

​
year
string
required

Ano de validade do cartão (obrigatório)

Example:

"29"

​
security_code
string
required

Código de segurança do cartão (obrigatório)

Example:

"789"

Response

Cartão alterado com sucesso

​
mensagem
string
Example:

"Operação realizada com sucesso"

​
erro
boolean
Example:

false

​
mensagenserro
string[]
Example:
[]
​
codigoretorno
integer
Example:

200

​
id
string
Example:

"00000000-0000-0000-0000-000000000000"

​
data
object

Dados retornados pela operação (objeto, array ou vazio)