/v1/customers/:customer_id/cards/:id
BASE URI https://api.mercadopago.com/v1/customers/{customer_id}/cards/{id}
Request Params
ParameterTypeDescription
id
String
Card ID.
customer_id
String
Customer ID.
expiration_month
Integer
Card's expiration month.
expiration_year
Integer
Card's expiration year.
first_six_digits
String
Card's first six digits.
last_four_digits
String
Card's last four digits.
payment_method
Object
Payment method information.
id
String
Payment method ID.
name
String
Payment method name.
payment_type_id
String
Payment method type.
thumbnail
String
Payment method thumbnail.
secure_thumbnail
String
Payment method secure thumbnail.
security_code
Object
Security code information.
length
Integer
Security code's length.
card_location
String
Security code's card location.
issuer
Object
Issuer information.
id
Integer
Issuer Id.
name
String
Issuer name.
cardholder
Object
Card holder information.
name
Integer
Card holder name.
identification
Integer
Identification information.
number
Integer
Identification number.
subtype
String
Identification subtype.
type
String
Identification type.
date_created
Date(ISO_8601)
Card's date created.
date_last_updated
Date(ISO_8601)
Card's last modified date.
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.