/v1/customers/:customer_id/cards
BASE URI https://api.mercadopago.com/v1/customers/{customer_id}/cards
HTTP Request
curl
curl -X GET \
'https://api.mercadopago.com/v1/customers/{customer_id}/cards' \
-H 'Authorization: Bearer ACCESS_TOKEN_ENV'
Request Params
ParameterTypeDescription
id
String
Identificador de cartão.
customer_id
String
Identificador de cliente.
expiration_month
Integer
Mês de validade do cartão.
expiration_year
Integer
Ano de validade do cartão.
first_six_digits
String
Os primeiros seis dígitos do cartão.
last_four_digits
String
Últimos quatro dígitos do cartão.
payment_method
Object
Informação dos meios de pagamento.
id
String
Id do meio de pagamento.
name
String
Nome do meio de pagamento.
payment_type_id
String
Tipo do meio de pagamento.
thumbnail
String
Thumbnail do meio de pagamento.
secure_thumbnail
String
Secure thumbnail do meio de pagamento.
security_code
Object
Informação do código de segurança.
length
Integer
Comprimento do código de segurança.
card_location
String
Localização do código de segurança no cartão.
issuer
Object
Informações do emitente.
id
Integer
Id do remetente.
name
String
Nome do emitente.
cardholder
Object
Informações do dono do cartão.
name
Integer
O nome.
identification
Integer
Informação de identificação.
number
Integer
Número de identificação.
subtype
String
Subtipo de identificação.
type
String
Tipo de identificação.
date_created
Date(ISO_8601)
Data de criação do cartão.
date_last_updated
Date(ISO_8601)
Última data de atualização do cartão.
Error Codes
CodeDescription
400 BAD_REQUEST
100
the credentials are required.
101
the customer already exist.
102
missing customer id.
103
parameter must be an object
104
parameter length is too large.
105
the customer id is invalid.
106
the email format is invalid.
107
the first_name is invalid.
108
the last_name is invalid.
109
the phone.area_code is invalid.
110
the phone.number is invalid.
111
the identification.type is invalid.
112
the identification.number is invalid.
113
the address.zip_code is invalid.
114
the address.street_name is invalid.
115
the date_registered format is invalid.
116
the description is invalid.
117
the metadata is invalid.
118
the body must be a Json Object.
119
the card is required.
120
card not found.
121
the card is invalid.
122
the card data is invalid.
123
the payment_method_id is required.
124
the issuer_id is required.
125
invalid parameters.
126
invalid parameter. You cannot update the email.
127
invalid parameter. Cannot resolve the payment method of card, check the payment_method_id and issuer_id.
128
the email format is invalid. Use 'test_payer_[0-9]{1,10}@testuser.com'.
129
the customer has reached the maximum allowed number of cards.
140
invalid card owner.
150
invalid users involved.
200
invalid range format (range=:date_parameter:after::date_from,before::date_to).
201
range attribute must belong to date entity.
202
invalid 'after' parameter. It should be date[iso_8601].
203
invalid 'before' parameter. It should be date[iso_8601].
204
invalid filters format.
205
invalid query format.
206
attributes to sort must belong to 'customer' entity.
207
order filter must be 'asc' or 'desc'.
208
invalid 'sort' parameter format.
401 UNAUTHORIZED
unauthorized
unauthorized.
404 NOT_FOUND
not_found
not_found.