Salvar cartão - Cartões - Mercado Pago Developers
Salvar cartão

POST

/v1/customers/{customer_id}/cards
Armazena com segurança em nossos servidores a referência a um cartão utilizado pelo cliente no pagamento para evitar pedir todos os dados em transações futuras.
Parâmetros de requisição
customer_id

OBRIGATÓRIO

string
Localização: pathCustomer's Id
token
string
Localização: bodyCard Token
Parâmetros de resposta
id
string
Localização: bodyid
expiration_month
number
Localização: bodyexpiration_month
expiration_year
number
Localização: bodyexpiration_year
first_six_digits
string
Localização: bodyfirst_six_digits
Solicitação
curl
curl -X POST \
    'https://api.mercadopago.com/v1/customers/{customer_id}/cards' \
    -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
    -H 'Content-Type: application/json' \
    -d '{
  "token": "9b2d63e00d66a8c721607214ceda233a"
}'
Resposta
json
{
  "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-03T21:15:35.000Z",
  "date_last_updated": "2019-07-03T21:19:18.000Z",
  "customer_id": "448870796-7ZjwhKGxILixxN",
  "user_id": 448870796,
  "live_mode": true
}
Erros
400bad_request
100100--the credentials are required.
101101--the customer already exist.
102102--missing customer id.
103103--parameter must be an object
104104--parameter length is too large.
105105--the customer id is invalid.
106106--the email format is invalid.
107107--the first_name is invalid.
108108--the last_name is invalid.
109109--the phone.area_code is invalid.
110110--the phone.number is invalid.
111111--the identification.type is invalid.
112112--the identification.number is invalid.
113113--the address.zip_code is invalid.
114114--the address.street_name is invalid.
115115--the date_registered format is invalid.
116116--the description is invalid.
117117--the metadata is invalid.
118118--the body must be a Json object
119119--the card is required.
120120--card not found.
121121--the card is invalid.
122122--the card data is invalid.
123123--the payment_method_id is required.
124124--the issuer_id is required.
125125--invalid parameters.
126126--invalid parameter. You cannot update the email.
127127--invalid parameter. Cannot resolve the payment method of card, check the payment_method_id and issuer_id.
128128--the email format is invalid. Use 'test_payer_[0-9]{1,10}@testuser.com'.
129129--the customer has reached the maximum allowed number of cards.
140140--invalid card owner.
150150--invalid users involved.
200200--invalid range format (range=:date_parameter:after::date_from,before::date_to).
201201--range attribute must belong to date entity.
202202--invalid 'after' parameter. It should be date[iso_8601].
203203--invalid 'before' parameter. It should be date[iso_8601].
204204--invalid filters format.
205205--invalid query format.
206206--attributes to sort must belong to 'customer' entity.
207207--order filter must be 'asc' or 'desc'.
208208--invalid 'sort' parameter format.
401bad_request
unauthorizedunauthorized--unauthorized.
404bad_request
not_foundnot_found--not_found.