Skip to main content
PUT
Atualizar cartão
Requer o header account com o código da conta. Apenas name, type, flag e a validade (month + year, enviados juntos) podem ser alterados.
O número do cartão e o código de segurança são imutáveis. Para trocá-los, cadastre um novo cartão. Cada atualização emite um evento card.updated. Ao alterar a validade, a tokenização é reiniciada e o resultado é enviado por webhook (card.token_created / card.token_failed).

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

clientCode
string
required

Código único do cliente dono do cartão

Example:

"cli_abc123"

cardId
string<uuid>
required

UUID do cartão

Example:

"9b2f5c8e-3a1d-4f7b-8c6e-2d9a1b4c5e6f"

Body

application/json

Todos os campos são opcionais. O número e o código de segurança são imutáveis. Ao enviar a validade, month e year devem vir juntos.

name
string

Nome do portador impresso no cartão

Maximum string length: 255
Example:

"Peter Parker"

type
enum<string>

Tipo do cartão

Available options:
credit,
debit
Example:

"credit"

flag
enum<string>

Bandeira do cartão

Available options:
visa,
mastercard,
elo,
amex
Example:

"mastercard"

month
integer

Mês de validade (obrigatório junto com year)

Required range: 1 <= x <= 12
Example:

12

year
integer

Ano de validade (obrigatório junto com month)

Example:

2030

Response

Cartão atualizado com sucesso

mensagem
string
Example:

"Cartão recebido. A tokenização foi iniciada; o resultado será enviado por webhook."

erro
boolean
Example:

false

mensagenserro
string[]
Example:
codigoretorno
integer
Example:

201

id
string
Example:

"00000000-0000-0000-0000-000000000000"

data
object