Crie o cliente e o cartão através das APIs de Criar clienteAPI e Salvar cartãoAPI. Para isso, você deve utilizar seu Access Token de produçãoChave privada da aplicação criada no Mercado Pago, utilizada no backend para operações de produção. Você pode acessá-la em Suas integrações > Detalhes da aplicação > Credenciais de produção.. Siga estes passos.

1. Envie uma solicitação POST ao endpoint /v1/customersAPI para criar o cliente.

curl
Copiar
curl -X POST \
    'https://api.mercadopago.com/v1/customers'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer APP_USR-1*********685765-12*********1b4332e5c*********e077d7679*********664' \
    -d '{
  "email": "jhon@doe.com",
  "first_name": "Jhon",
  "last_name": "Doe",
  "phone": {
    "area_code": "55",
    "number": "991234567"
  },
  "identification": {
    "type": "CPF",
    "number": "12345678900"
  },
  "default_address": "Home",
  "address": {
    "id": "123123",
    "zip_code": "01234567",
    "street_name": "Rua Exemplo",
    "street_number": 123,
    "city": {}
  },
  "date_registered": "2021-10-20T11:37:30.000-04:00",
  "description": "Description del user",
  "default_card": "None"
}'

2. Envie uma solicitação POST ao endpoint /v1/customers/{id}/cardsAPI com o ID do Cliente (customer_id) no path para realizar a associação, e o token de cartão no body da requisição.

curl
Copiar
curl -X POST \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer ENV_ACCESS_TOKEN' \
  'https://api.mercadopago.com/v1/customers/CUSTOMER_ID/cards' \
  -d '{"token": "9b2d63e00d66a8c721607214cedaecda"}'

Após a criação bem-sucedida, os objetos são identificados com estes prefixos:

A resposta trará o seguinte resultado:

json
Copiar
{
    "id": "123456789-jxOV430go9fx2e",
    "email": "test_payer_12345@testuser.com",
    ...
    "default_card": "1490022319978",
    "default_address": null,
    "cards": [{
        "id": "1490022319978",
        "expiration_month": 12,
        "expiration_year": 2020,
        "first_six_digits": "415231",
        "last_four_digits": "0001",
        ...
    }],
    "addresses": [],
    "live_mode": false
}

Atualize qualquer informação de um cliente, como endereço, cartão ou e-mail. Você pode realizar esta operação através da API do Mercado Pago.

Envie uma solicitação PUT ao endpoint /v1/customers/{id}API com o ID do Cliente (customer_id) no path e os atributos a modificar no body da requisição.

curl
Copiar
curl -X PUT \
    'https://api.mercadopago.com/v1/customers/{id}' \
    -H 'Authorization: Bearer ACCESS_TOKEN_ENV' \
    -d '{
  "email": "user@user.com",
  "first_name": "john",
  "last_name": "wagner",
  "address": {
    "zip_code": "52",
    "street_name": "Av. das Nações Unidas",
    "street_number": "2"
  },
  "phone": {
    "area_code": "11",
    "number": "001234567"
  },
  "identification": {
    "type": "CPF",
    "number": "12341234"
  },
  "description": "Informações do cliente" 
}'

O endpoint aceita a modificação de todos os atributos descritos na tabela a seguir.

A resposta trará o seguinte resultado:

json
Copiar
{
  "id": "xxxxxxxxxxxxxxxxxxxxx",
  "email": "user@user.com",
  "first_name": "john",
  "last_name": "wagner",
  "phone": {
    "area_code": "11",
    "number": "001234567"
  },
  "identification": {
    "type": "CPF",
    "number": "12341234"
  },
  "address": {
    "zip_code": "52",
    "street_name": "Av. das Nações Unidas",
    "street_number": 2
  },
  "description": "Informações do cliente",
  "date_created": "2021-05-25T15:36:23.541Z",
  "metadata": {},
  "cards": [
    {}
  ],
  "addresses": [
    {}
  ]
}

Obtenha dados específicos de um cliente, como ID, endereço ou data de registro, através da API de Clientes. Você pode realizar esta operação através da API do Mercado Pago.

Envie uma solicitação GET ao endpoint /v1/customers/searchAPI especificando o e-mail do cliente como parâmetro de consulta.

curl
Copiar
curl -X GET \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer ENV_ACCESS_TOKEN' \
  'https://api.mercadopago.com/v1/customers/search?email=test_user_19653727@testuser.com'

A resposta mostrará este resultado:

json
Copiar
{
    "paging": {
        "limit": 10,
        "offset": 0,
        "total": 1
    },
    "results": [
        {
            "address": {
                "id": null,
                "street_name": null,
                "street_number": null,
                "zip_code": null
            },
            "addresses": [],
            "cards": [
                {
                    ...
                }
            ],
            "date_created": "2017-05-05T00:00:00.000-04:00",
            "date_last_updated": "2017-05-05T09:23:25.021-04:00",
            "date_registered": null,
            "default_address": null,
            "default_card": "1493990563105",
            "description": null,
            "email": "test_payer_12345@testuser.com",
            "first_name": null,
            "id": "123456789-jxOV430go9fx2e",
            "identification": {
                "number": null,
                "type": null
            },
            "last_name": null,
            "live_mode": false,
            "metadata": {},
            "phone": {
                "area_code": null,
                "number": null
            }
        }
    ]
}

Associe cartões adicionais a um cliente registrado. Você pode realizar esta operação através da API do Mercado Pago.

Envie uma solicitação POST ao endpoint /v1/customers/{customer_id}/cardsAPI com o ID do Cliente (customer_id) no path e os dados do cartão no body da requisição.

curl
Copiar
curl -X POST \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer ENV_ACCESS_TOKEN' \
    'https://api.mercadopago.com/v1/customers/CUSTOMER_ID/cards' \
    -d '{"token": "9b2d63e00d66a8c721607214cedaecda"}'

A resposta trará o seguinte resultado:

json
Copiar
{
    "id": "1493990563105",
    "expiration_month": 12,
    "expiration_year": 2020,
    "first_six_digits": "503175",
    "last_four_digits": "0604",
    "payment_method": {
        "id": "master",
        "name": "master",
        "payment_type_id": "credit_card",
        "thumbnail": "http://img.mlstatic.com/org-img/MP3/API/logos/master.gif",
        "secure_thumbnail": "https://www.mercadopago.com/org-img/MP3/API/logos/master.gif"
    },
    "security_code": {
        "length": 3,
        "card_location": "back"
    },
    "issuer": {
        "id": 3,
        "name": "Mastercard"
    },
    "cardholder": {
        "name": "Card holdername",

        "identification": {
            "number": "12345678",
            "type": "DNI"
        }

    },
    "date_created": "2017-05-05T09:22:30.893-04:00",
    "date_last_updated": "2017-05-05T09:22:30.893-04:00",
    "customer_id": "255276729-yLOTNHQjpDWw1X",
    "user_id": "255276729",
    "live_mode": false
}

Consulte todos os cartões associados a um cliente. Você pode realizar esta operação através da API do Mercado Pago.

Envie uma solicitação GET ao endpoint /v1/customers/{customer_id}/cardsAPI com o ID do Cliente (customer_id) no path.

curl
Copiar
curl -X GET \
  -H 'Authorization: Bearer ENV_ACCESS_TOKEN' \
  'https://api.mercadopago.com/v1/customers/CUSTOMER_ID/cards' \

A resposta será um array com todos os objetos de cartão salvos para o cliente.

json
Copiar
[{
    "id": "1490022319978",
    "expiration_month": 12,
    "expiration_year": 2020,
    "first_six_digits": "415231",
    "last_four_digits": "0001",
    ...
}]

Para que um cliente efetue um pagamento com cartões salvos, você deve capturar novamente o código de segurança (CVV) do cartão, já que o Mercado Pago não armazena este dado por razões de segurança. Você pode realizar esta operação através da API do Mercado Pago.

Mostre ao comprador a lista de cartões salvos para que ele escolha a opção desejada.

Para isso, envie um GET ao endpoint /v1/customers/{customer_id}/cardsAPI com o ID do Cliente (customer_id) no path.

curl
Copiar
curl -X GET \
  -H 'Authorization: Bearer ENV_ACCESS_TOKEN' \
  'https://api.mercadopago.com/v1/customers/CUSTOMER_ID/cards' \

Depois de mostrar os cartões salvos ao comprador, prossiga com a criação do formulário de pagamento.

Esta etapa permite ao comprador ver onde deve incluir o código de segurança (CVV) do cartão selecionado. Para realizá-la, implemente o código a seguir diretamente no seu projeto.

html
Copiar
<style>
    #form-checkout {
      display: flex;
      flex-direction: column;
      max-width: 600px;
    }

    .container {
      height: 18px;
      display: inline-block;
      border: 1px solid rgb(118, 118, 118);
      border-radius: 2px;
      padding: 1px 2px;
    }
  </style>
  <form id="form-checkout" method="POST" action="/process_payment">
    <select type="text" id="form-checkout__cardId"></select>
    <div id="form-checkout__securityCode-container" class="container"></div>
    <input name="token" id="token" hidden>
    <button>Enviar</button>
  </form>

<script>
    const mp = new MercadoPago('TEST-2bf9f710-6a6e-47c8-a207-79f5e73b464c');

    const securityCodeElement = mp.fields.create('securityCode', {
      placeholder: "CVV"
    }).mount('form-checkout__securityCode-container');

    const customerCards = [{
      "id": "3502275482333",
      "last_four_digits": "9999",
      "payment_method": {
        "name": "amex",
      },
      "security_code": {
        "length": 4,
      }
    }];

    function appendCardToSelect() {
      const selectElement = document.getElementById('form-checkout__cardId');
      const tmpFragment = document.createDocumentFragment();
      customerCards.forEach(({ id, last_four_digits, payment_method }) => {
        const optionElement = document.createElement('option');
        optionElement.setAttribute('value', id)
        optionElement.textContent = `${payment_method.name} ended in ${last_four_digits}`
        tmpFragment.appendChild(optionElement);
      })
      selectElement.appendChild(tmpFragment)
    }

    appendCardToSelect();

</script>

Após exibir os cartões salvos e criar o formulário de pagamento, o próximo passo é capturar o código de verificação (CVV) do cartão e gerar o token de segurança.

Para isso, você deve criar um token enviando o formulário com o ID do cartão selecionado pelo cliente e o código de segurança (CVV) utilizando o código Javascript a seguir.

javascript
Copiar
const formElement = document.getElementById('form-checkout');
    formElement.addEventListener('submit', e => createCardToken(e));
    const createCardToken = async (event) => {
      try {
        const tokenElement = document.getElementById('token');
        if (!tokenElement.value) {
          event.preventDefault();
          const token = await mp.fields.createCardToken({
            cardId: document.getElementById('form-checkout__cardId').value
          });
          tokenElement.value = token.id;
          console.log(tokenElement);
        }
      } catch (e) {
        console.error('error creating card token: ', e)
      }
    }

Uma vez que você tenha obtido o token de segurança do cartão na etapa anterior, o passo final é criar o pagamento com o valor correspondente.

Envie uma solicitação POST ao endpoint /v1/ordersAPI incluindo o payer.customer_id e o payment_method.token no corpo da solicitação, enviando os seguintes dados.

curl
Copiar
curl --request POST \
  --url https://api.mercadopago.com/v1/orders \
  --header 'Content-Type: application/json' \
  --data '{
  "type": "online",
  "external_reference": "ext_ref_1234",
  "total_amount": "200.00",
  "payer": {
    "customer_id": "{{CUSTOMER_ID}}"
  },
  "transactions": {
    "payments": [
      {
        "amount": "200.00",
        "payment_method": {
          "id": "{{PAYMENT_METHOD_ID}}",
          "type": "{{PAYMENT_METHOD_TYPE}}",
          "token": "{{CARD_TOKEN}}",
          "installments": 1
        }
      }
    ]
  }
}'

Realiza a exclusão de um cartão específico associado a um cliente salvo, assegurando a atualização dos dados. A operação está disponível via API do Mercado Pago ou pelos SDKs disponíveis.

Envie uma solicitação DELETE ao endpoint /v1/customers/{customer_id}/cards/{id}API com o ID do Cliente (customer_id) e o ID do Cartão (id) como parâmetros de path.

curl
Copiar
curl -X DELETE \
    'https://api.mercadopago.com/v1/customers/12123adfasdf123u4u/cards/12123adfasdf123u4u'\
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer TEST-7434*********159-03141*********cee51edf8*********f94f589-1*********' \

A resposta trará este resultado:

json
Copiar
{
   "id": "8987269652",
   "expiration_month": 7,
   "expiration_year": 2023,
   "first_six_digits": "503143",
   "last_four_digits": "6351",
   "payment_method": {
     "id": "master",
     "name": "Mastercard",
     "payment_type_id": "credit_card",
     "thumbnail": "http://img.mlstatic.com/org-img/MP3/API/logos/master.gif",
     "secure_thumbnail": "https://www.mercadopago.com/org-img/MP3/API/logos/master.gif"
   },
   "security_code": {
     "length": 3,
     "card_location": "back"
   },
   "issuer": {
     "id": 24,
     "name": "Mastercard"
   },
   "cardholder": {
     "name": "APRO",
     "identification": {
       "number": "01234567890",
       "type": "CPF"
     }
   },
   "date_created": "2021-03-16T16:08:21.000-04:00",
   "date_last_updated": "2021-03-16T16:14:40.962-04:00",
   "customer_id": "470183340-cpunOI7UsIHlHr",
   "user_id": "470183340",
   "live_mode": true
}