{
"object": "card",
"id": "<string>",
"last_four": "<string>",
"exp_month": 6,
"exp_year": 123,
"holder_name": "<string>",
"expired": true,
"created_at": "2023-11-07T05:31:56Z",
"last_used_at": "2023-11-07T05:31:56Z"
}Objetos
Cartão guardado
Campo a campo do cartão no cofre — o pm_ que cobra de novo sem pedir nada ao comprador.
O que as rotas de
Um cartão vencido continua na lista, com
Carimbado só depois de uma cobrança dar certo. A distinção importa: se o carimbo acontecesse
antes da chamada ao provedor, um cartão recusado sairia com
/v1/cards devolvem. O id (pm_…) é o que vai em card.id numa
cobrança, e é a única referência ao cartão que sai da nossa casa.
Todo campo está sempre presente.
O que NÃO está aqui
As referências da Pagar.me que de fato cobram, e os seis primeiros dígitos. As primeiras são o equivalente ao cartão para quem as tem — opm_ existe justamente para que ninguém precise delas. O
BIN somado aos quatro últimos é material de correlação.
expired é estado, não ausência
Um cartão vencido continua na lista, com expired: true. É o que permite você entender por que a
cobrança de um clique parou de funcionar para aquele comprador, em vez de o cartão simplesmente
desaparecer.
Ele sai da listagem por padrão: peça include_expired=1 para vê-lo.
last_used_at e a ordem da lista
Carimbado só depois de uma cobrança dar certo. A distinção importa: se o carimbo acontecesse
antes da chamada ao provedor, um cartão recusado sairia com last_used_at de agora — e como a lista
é ordenada por esse campo, o cartão que acabou de falhar viraria o pré-escolhido da tentativa
seguinte.
Veja também
Cofre de cartões
Como um cartão entra, e as duas formas de guardar.
Assinaturas
Cobrar em série com o
pm_, e o que a bandeira exige.Um cartão guardado. Todo campo está sempre presente.
O que NÃO está aqui, e não vai estar: as referências da Pagar.me que de fato cobram, e os seis primeiros dígitos. As primeiras são o equivalente ao cartão para quem as tem; o BIN somado aos quatro últimos é material de correlação que você não precisa.
Allowed value:
"card"Pattern:
^pm_[0-9a-z]{26}$Available options:
visa, mastercard, elo, hipercard, amex, diners, discover, aura, null Required range:
1 <= x <= 12Vencido é ESTADO, e não ausência: o cartão continua na lista para você entender por que a cobrança de um clique parou de funcionar para aquele comprador.