Consulta um cartão

GET/v1/cards/{cardId}

Autentique com o header SelectKey: a chave sk_test_ opera no sandbox, a sk_live_ em produção. Como autenticar.

Parâmetros do caminho

cardIdstringobrigatório
Identificador público (card_…)

Respostas

200Sucesso

idstringobrigatório
Identificador público (card_…)
brandstringobrigatório
Bandeira do cartão (ex.: visa, mastercard).
validbooleanobrigatório
Se o cartão passou na validação.
_linksobject
Links para operações relacionadas, por ação (self, create, update, delete, list…).
activebooleanobrigatório
Se o cartão pode ser cobrado.
primarybooleanobrigatório
Se é o cartão principal do cliente.
merchantobject
A conta dona do recurso (o vendedor de registro).
+3 campos de merchant
- namestringobrigatóriopode ser nulo
  Nome fantasia da conta dona do recurso.
- merchantIdstringobrigatóriopode ser nulo
  Id público da conta dona do recurso (bus_…).
- isSubAccountbooleanobrigatório
  true quando o recurso pertence a uma sub-conta operada por uma plataforma de marketplace.
verifiedbooleanobrigatório
Se o cartão foi verificado com o emissor.
createdAtstringobrigatório
Quando o recurso foi criado (ISO 8601, UTC).
updatedAtstringobrigatório
Quando o recurso foi atualizado pela última vez (ISO 8601, UTC).
associatedbooleanobrigatóriopode ser nulo
Se o cartão está vinculado ao cliente para cobrança. null = pendente: o cartão entrou por uma tela do comprador e ainda não tem cobrança aprovada.
holderNamestringobrigatóriopode ser nulo
Nome impresso no cartão.
lastDigitsstringobrigatório
Quatro últimos dígitos do cartão.
firstDigitsstringobrigatório
Seis primeiros dígitos do cartão (BIN).
expirationYearstringobrigatório
Ano de validade (YYYY).
expirationMonthstringobrigatório
Mês de validade (MM).

401Não autenticado (credencial ausente ou inválida)

errorobjectobrigatório
+8 campos de error
- codestringobrigatório
- paramsobject[]
- statusstringobrigatório
- detailsstring
- messagestringobrigatório
- categorystringobrigatório
  Valores:validationauthenticationauthorizationpaymentclientserverrate_limitpending
- resourcestringobrigatório
- statusCodeintegerobrigatório

403Sem permissão

errorobjectobrigatório
+8 campos de error
- codestringobrigatório
- paramsobject[]
- statusstringobrigatório
- detailsstring
- messagestringobrigatório
- categorystringobrigatório
  Valores:validationauthenticationauthorizationpaymentclientserverrate_limitpending
- resourcestringobrigatório
- statusCodeintegerobrigatório

404Não encontrado

errorobjectobrigatório
+8 campos de error
- codestringobrigatório
- paramsobject[]
- statusstringobrigatório
- detailsstring
- messagestringobrigatório
- categorystringobrigatório
  Valores:validationauthenticationauthorizationpaymentclientserverrate_limitpending
- resourcestringobrigatório
- statusCodeintegerobrigatório

409Conflito (idempotência ou estado)

errorobjectobrigatório
+8 campos de error
- codestringobrigatório
- paramsobject[]
- statusstringobrigatório
- detailsstring
- messagestringobrigatório
- categorystringobrigatório
  Valores:validationauthenticationauthorizationpaymentclientserverrate_limitpending
- resourcestringobrigatório
- statusCodeintegerobrigatório

500Erro interno do servidor

errorobjectobrigatório
+8 campos de error
- codestringobrigatório
- paramsobject[]
- statusstringobrigatório
- detailsstring
- messagestringobrigatório
- categorystringobrigatório
  Valores:validationauthenticationauthorizationpaymentclientserverrate_limitpending
- resourcestringobrigatório
- statusCodeintegerobrigatório

AnteriorCria um cartão PróximaExclui um cartão