Buscar Token do Cartão

Recuperar Card Tokens

get

https://api.barte.comhttps://sandbox-api.barte.com

/payment/v1/cards/{buyerUuid}

Retorna todos os tokens de cartão associados a um comprador específico. Útil para listar cartões salvos do cliente.

Authorizations

X-Token-Api

X-Token-ApistringRequired

Path parameters

buyerUuidstring · uuidRequired

UUID do comprador

Responses

200

Lista de tokens de cartão recuperada com sucesso

application/json

uuidstring · uuidOptional

UUID do token

Example: eecf6e10-e81c-4ab4-8738-1ba8e3a59429

statusstring · enumOptional

Status do token

Example: ACTIVEPossible values:

createdAtstring · dateOptional

Data de criação

Example: 2025-08-20

brandstring · enumOptional

Bandeira do cartão

Example: mastercardPossible values:

first6digitsstringOptional

Primeiros 6 dígitos

Example: 518688

last4digitsstringOptional

Últimos 4 dígitos

Example: 5601

buyerIdstring · uuidOptional

UUID do comprador

Example: 6a77d1bb-8589-4402-b5e1-2bece903daa6

expirationMonthstringOptional

Mês de expiração

Example: 10

expirationYearstringOptional

Ano de expiração

Example: 2025

cardIdstring · uuidOptional

ID do cartão para uso em pagamentos

Example: c69bb196-6abd-46bb-8a81-7cc15c8d69cb

400

Requisição inválida

application/json

401

Não autorizado

application/json

403

Acesso proibido

application/json

500

Erro interno do servidor

application/json

get

/payment/v1/cards/{buyerUuid}

HTTPcURLJavaScriptPython

GET /payment/v1/cards/{buyerUuid} HTTP/1.1
Host: api.barte.com
X-Token-Api: YOUR_API_KEY
Accept: */*

[
  {
    "uuid": "eecf6e10-e81c-4ab4-8738-1ba8e3a59429",
    "status": "ACTIVE",
    "createdAt": "2025-08-20",
    "brand": "mastercard",
    "first6digits": "518688",
    "last4digits": "5601",
    "buyerId": "6a77d1bb-8589-4402-b5e1-2bece903daa6",
    "expirationMonth": "10",
    "expirationYear": "2025",
    "cardId": "c69bb196-6abd-46bb-8a81-7cc15c8d69cb"
  }
]