BASE URI https://api.mercadopago.com/v1/customers/{customer_id}/cards

HTTP Request


 curl -X POST \
  'https://api.mercadopago.com/v1/customers/{customer_id}/cards' \
  -H 'Authorization: Bearer ACCESS_TOKEN_ENV' \
  -d '{
    "token": "b3a7dbec3eb0d71798c4f19fec445795"

Request Params


HTTP Response


    "id": "1562188766852",
    "expiration_month": 6,
    "expiration_year": 2023,
    "first_six_digits": "423564",
    "last_four_digits": "5682",
    "payment_method": {
        "id": "visa",
        "name": "visa",
        "payment_type_id": "credit_card",
        "thumbnail": "http://img.mlstatic.com/org-img/MP3/API/logos/visa.gif",
        "secure_thumbnail": "https://www.mercadopago.com/org-img/MP3/API/logos/visa.gif"
    "security_code": {
        "length": 3,
        "card_location": "back"
    "issuer": {
        "id": 25,
        "name": "Visa"
    "cardholder": {
        "name": "APRO",
        "identification": {
            "number": "19119119100",
            "type": "CPF"
    "date_created": "2019-07-03T17:15:35.000-04:00",
    "date_last_updated": "2019-07-03T17:19:18.000-04:00",
    "customer_id": "448870796-7ZjwhKGxILixxN",
    "user_id": "448870796",
    "live_mode": false

Error Codes

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.
unauthorized unauthorized.
not_found not_found.

Sua pesquisa não retorna resultados.

Check the spelling of search terms or test with other keywords.