Retornar Cartão

Use essa rota para retornar um objeto com os dados de um cartão previamente criado. Apenas o card_id passado no PATH do endpoint é necessário.

GET/v2/cards/:card_id

Request Variável Path

Atributo	Tipo	Descrição
card_id	string	ID do cartão salvo anteriormente.

Response Object

Propriedade	Tipo	Descrição
card_id	string	Hash identificador do cartão.
date_created	dateTime	Data de criação do cartão no formato ISODateTime.
date_updated	dateTime	Data de atualização do cartão no formato ISODateTime.
card_holder_name	string	Nome do portador do cartão.
card_brand	string	Bandeira do cartão. Valores possíveis: visa, mastercard, amex, hipercard e elo.
card_first_digits	string	Primeiros 6 dígitos do cartão.
card_last_digits	string	Últimos 4 dígitos do cartão.
card_expiration_date	string	Data de validade do cartão. Somente números no formato MMAA.
valid	boolean	Propriedade para verificar a validade do cartão, ou seja, caso true, é possível cobrar o cartão em condições normais, para false, não pode ser utilizado.

Exemplos

Cartão Encontrado

Request

curl -X GET -G "https://api.crypto.marlim.co/v2/cards/card_princess12leia45organa678" \
-H "Content-Type: application/json" \
-H "api_key: api_key_value" \

Response200

{
  "card_id": "card_princess12leia45organa678",
  "date_created": "2024-02-16T19:58:04.395Z",
  "date_updated": "2024-02-16T19:58:04.395Z",
  "card_holder_name": "Leia S O Solo",
  "card_brand": "mastercard",
  "card_first_digits": "444455",
  "card_last_digits": "3333",
  "card_expiration_date": "0504",
  "valid": true
}

Cartão Não Encontrado

Request

curl -X GET -G "https://api.crypto.marlim.co/v2/cards/card_wookiee123chewbacca456789" \
-H "Content-Type: application/json" \
-H "api_key: api_key_value" \

Response400

{
  "errors": {
    "type": "not_found",
    "message": "Card with ID 'card_wookiee123chewbacca456789' was not found."
  }
}