Dados de indústria
De acordo com o ramo de atividades ou setor da sua loja, você pode incluir informações adicionais no momento de criar o pagamento que ajudam a aumentar as possibilidades de aprovação. A seguir, você encontrará alguns dados específicos para essas indústrias que pode adicionar à sua integração.
Adicione qualquer informação extra que considerar necessária sobre:
- Itens (array
items)
Array items | Tipo | Descrição |
id | String | Código |
title | String | Nome |
type | String | Tipo |
description | String | Descrição |
picture_url | String | Imagem URL |
category_id | String | Categoria |
quantity | Integer | Quantidade |
unit_price | Float | Preço unitário |
- Comprador (object
payer)
Object payer | Tipo | descrição |
first_name | String | Nome |
last_name | String | Sobrenome |
identification | Object | Dados de identificação |
identification_type | String | Tipo de identificação |
identification_number | String | Número de identificação |
phone | Object | Telefone |
area_code | Integer | Código de área |
number | Integer | Número de telefone |
address | Object | Dados do endereço |
zip_code | String | Código postal |
street_name | String | Nome da rua |
street_number | Integer | Número da rua |
authentication_type | Enum | Tipo de autenticação ("Gmail" - "Facebook" - "Web Nativa" - "Outro") |
registration_date | Date | Data de registro do comprador no site. |
is_prime_user | Boolean | True se é, False se nao é. |
is_first_purchase_online | Boolean | True se é, False se não é. |
last_purchase | Date | Data da última compra no site. |
- Entregas (object
shipment)
Object shipment | Tipo | Descrição |
receiver_address | Object | Dados do endereço do comprador. |
zip_code | String | Código postal |
state_name | String | Província |
city_name | String | Cidade |
street_number | Integer | Número da rua |
express_shipment | Boolean | True se é, False se não é. |
A seguir, você encontrará um exemplo de como enviar os dados apresentados nas tabelas acima:
curl
curl --location --request POST 'https://api.mercadopago.com/checkout/preferences' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \ --data-raw '{ "auto_return": "approved", "back_urls": { "failure": "https://www.mercadopago.com/home/failure", "pending": "https://www.mercadopago.com/home/pending", "success": "https://www.mercadopago.com/home/success" }, "notification_url": "https://webhook.site/xyz", "expires": false, "external_reference": "order-123", "date_of_expiration": "2025-03-12T12:58:41.425-04:00", "items": [ { "id": "1234", "currency_id": "PEN", "title": "Produto", "picture_url": "", "description": "Descrição de produto", "type": "test", "category_id": "fashion", "quantity": 1, "unit_price": 150 } ], "payer": { "phone": { "area_code": "11", "number": "643863703" }, "address": { "zip_code": "52", "street_name": "German Schreiber Gulsmanco", "street_number": 1000 }, "identification": { "identification_type": "RUC", "identification_number": "12345678" }, "email": "john@yourdomain.com", "first_name": "Pilar", "last_name": "Palomo", "date_created": "", "authentication_type": "Facebook", "registration date": "2015-06-02T12:58:41.425-04:00", "is_prime_user": false, "is_first_purchase_online": false, "last_purchase": "2020-01-02T12:58:41.425-04:00" }, "payment_methods": { "excluded_payment_methods": [ { "id": "" } ], "default_installments": null, "default_payment_method_id": null, "excluded_payment_types": [ { "id": "" } ], "installments": null }, "shipments": { "mode": "not_specified", "receiver_address": { "zip_code": "52", "street_name": "German Schreiber Gulsmanco", "city_name": "San Isidro", "state_name": "Lima", "street_number": 1000 }, "express_shipment": false } }'
Adicione qualquer informação extra que considerar necessária sobre:
- Itens (array
items)
Array items | Tipo | Descrição |
id | String | Código |
title | String | Nome |
category_id | String | Categoria |
quantity | Integer | Quantidade |
unit_price | Float | Preço unitário |
warranty | Boolean | True se o produto tiver garantia, False se não tiver. |
- Comprador (object
payer)
Object payer | Tipo | Descrição |
first_name | String | Nome |
last_name | String | Sobrenome |
identification | Object | Dados de identificação |
identification_type | String | Tipo de identificação |
identification_number | String | Número de identificação |
phone | Object | Telefone |
area_code | Integer | Código de área |
number | Integer | Número de telefone |
address | Object | Dados do endereço |
zip_code | String | Código postal |
street_name | String | Nome da rua |
street_number | Integer | Número da rua |
authentication_type | Enum | Tipo de autenticação ("Gmail" - "Facebook" - "Web Nativa" - "Outro") |
registration_date | Date | Data de registro do comprador no site. |
is_prime_user | Boolean | True se é, False se não é. |
is_first_purchase_online | Boolean | True se é, False se não é. |
last_purchase | Date | Data da última compra no site. |
- Entregas (object
shipment)
Object shipment | Tipo | Descrição |
local_pickup | Boolean | True se retira na agência ou na loja, False se não retira. |
receiver_address | Object | Dados do endereço do comprador. |
zip_code | String | Código postal |
state_name | String | Província |
city_name | String | Cidade |
street_number | Integer | Número da rua |
express_shipment | Boolean | True se é, False se não é. |
A seguir, você encontrará um exemplo de como enviar os dados apresentados nas tabelas acima:
curl
curl --location --request POST 'https://api.mercadopago.com/checkout/preferences' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \ --data-raw '{ "auto_return": "approved", "back_urls": { "failure": "https://www.mercadopago.com/home/failure", "pending": "https://www.mercadopago.com/home/pending", "success": "https://www.mercadopago.com/home/success" }, "notification_url": "https://webhook.site/xyz", "expires": false, "external_reference": "order-123", "date_of_expiration": "2025-03-12T12:58:41.425-04:00", "items": [ { "id": "1234", "currency_id": "PEN", "title": "Produto", "category_id": "phones", "quantity": 1, "unit_price": 150, "warranty": false, } ], "payer": { "phone": { "area_code": "11", "number": "643863703" }, "address": { "zip_code": "52", "street_name": "German Schreiber Gulsmanco", "street_number": 1000 }, "identification": { "identification_type": "RUC", "identification_number": "12345678" }, "email": "john@yourdomain.com”, "first_name": "Pilar", "last_name": "Palomo", "date_created": "", "authentication_type": "Facebook", "registration date": "2015-06-02T12:58:41.425-04:00", "is_prime_user": false, "is_first_purchase_online": false, "last_purchase": "2020-01-02T12:58:41.425-04:00" }, "payment_methods": { "excluded_payment_methods": [ { "id": "" } ], "default_installments": null, "default_payment_method_id": null, "excluded_payment_types": [ { "id": "" } ], "installments": null }, "shipments": { "mode": "not_specified", "receiver_address": { "zip_code": "52", "street_name": "German Schreiber Gulsmanco", "city_name": "San Isidro", "state_name": "Lima", "street_number": 1000 }, "express_shipment": false, "local_pickup": false } }'
Adicione qualquer informação extra que considerar necessária sobre:
- Itens (array
items)
Array items | Tipo | Descrição |
id | String | Código |
title | String | Nome |
category_id | String | Categoria |
quantity | Integer | Quantidade |
unit_price | Float | Preço unitário |
category_descriptor | Object | Descrição da categoria |
event_date | Date | Data do evento. Deve ser enviada dentro do objeto category_descriptor. Deve ser enviada no formato ISO 8601 (data e hora, em UTC). |
- Comprador (object
payer)
Object payer | Tipo | Descrição |
first_name | String | Nome |
last_name | String | Sobrenome |
identification | Object | Dados de identificação |
identification_type | String | Tipo de identificação |
identification_number | String | Número de identificação |
phone | Object | Telefone |
area_code | Integer | Código de área |
number | Integer | Número de telefone |
authentication_type | Enum | Tipo de autenticação ("Gmail" - "Facebook" - "Web Nativa" - "Outro") |
registration_date | Date | Data de registro do comprador no site. |
is_prime_user | Boolean | True se é, False se não é. |
is_first_purchase_online | Boolean | True se é, False se não é. |
last_purchase | Date | Data da última compra no site. |
- Entregas (object
shipment)
Object shipment | Tipo | Descrição |
receiver_address | Object | Dados do endereço do comprador. |
zip_code | String | Código postal |
state_name | String | Província |
city_name | String | Cidade |
street_number | Integer | Número da rua |
express_shipment | Boolean | True se é, False se não é. |
A seguir, você encontrará um exemplo de como enviar os dados apresentados nas tabelas acima:
curl
curl --location --request POST 'https://api.mercadopago.com/checkout/preferences' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \ --data-raw '{ "auto_return": "approved", "back_urls": { "failure": "https://www.mercadopago.com/home/failure", "pending": "https://www.mercadopago.com/home/pending", "success": "https://www.mercadopago.com/home/success" }, "notification_url": "https://webhook.site/xyz", "expires": false, "external_reference": "order-123", "date_of_expiration": "2025-03-12T12:58:41.425-04:00", "items": [ { "id": "1234", "currency_id": "PEN", "title": "Produto", "category_id": "entertainment", "quantity": 1, "unit_price": 150, "category_descriptor":{ "event_date": "2022-03-12T12:58:41.425-04:00" }, } ], "payer": { "phone": { "area_code": "11", "number": "643863703" }, "identification": { "identification_type": "RUC", "identification_number": "12345678" }, "email": "john@yourdomain.com", "first_name": "Pilar", "last_name": "Palomo", "date_created": "", "authentication_type": "Facebook", "registration date": "2015-06-02T12:58:41.425-04:00", "is_prime_user": false, "is_first_purchase_online": false, "last_purchase": "2020-01-02T12:58:41.425-04:00" }, "payment_methods": { "excluded_payment_methods": [ { "id": "" } ], "default_installments": null, "default_payment_method_id": null, "excluded_payment_types": [ { "id": "" } ], "installments": null }, "shipments": { "mode": "not_specified", "receiver_address": { "zip_code": "52", "street_name": "German Schreiber Gulsmanco", "city_name": "San Isidro", "state_name": "Lima", "street_number": 1000 }, "express_shipment": false, "local_pickup": false } }'
Adicione qualquer informação extra que considerar necessária sobre:
- Itens (array
items)
Array items | Tipo | Descrição |
id | String | Código |
title | String | Nome |
description | String | Descrição |
category_id | String | Categoria |
quantity | Integer | Quantidade |
unit_price | Float | Preço unitário |
warranty | Boolean | True se o produto tiver garantia, False se não tiver. |
- Comprador (object
payer)
Object payer | Tipo | Descrição |
first_name | String | Nome |
last_name | String | Sobrenome |
identification | Object | Dados de identificação |
identification_type | String | Tipo de identificação |
identification_number | String | Número de identificação |
phone | Object | telefone |
area_code | Integer | Código de área |
number | Integer | Número de telefone |
address | Object | Dados do endereço |
zip_code | String | Código postal |
street_name | String | Nome da rua |
street_number | Integer | Número da rua |
authentication_type | Enum | Tipo de autenticação ("Gmail" - "Facebook" - "Web Nativa" - "Outro") |
registration_date | Date | Data de registro do comprador no site. |
is_prime_user | Boolean | True se é, False se não é. |
is_first_purchase_online | Boolean | True se é, False se não é. |
last_purchase | Date | Data da última compra no site. |
- Entregas (object
shipment)
Object shipment | Tipo | Descrição |
receiver_address | Object | Dados do endereço do comprador. |
zip_code | String | Código postal |
state_name | String | Província |
city_name | String | Cidade |
street_number | Integer | Número da rua |
express_shipment | Boolean | True se é, False se não é. |
A seguir, você encontrará um exemplo de como enviar os dados apresentados nas tabelas acima:
curl
curl --location --request POST 'https://api.mercadopago.com/checkout/preferences' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \ --data-raw '{ "auto_return": "approved", "back_urls": { "failure": "https://www.mercadopago.com/home/failure", "pending": "https://www.mercadopago.com/home/pending", "success": "https://www.mercadopago.com/home/success" }, "notification_url": "https://webhook.site/xyz", "expires": false, "external_reference": "order-123", "date_of_expiration": "2025-03-12T12:58:41.425-04:00", "items": [ { "id": "1234", "currency_id": "PEN", "title": "Produto", "picture_url": "", "description": "Descrição de produto", "category_id": "home", "quantity": 1, "unit_price": 150, "warranty": false, } ], "payer": { "phone": { "area_code": "11", "number": "643863703" }, "address": { "zip_code": "52", "street_name": "German Schreiber Gulsmanco", "street_number": 1000 }, "identification": { "identification_type": "RUC", "identification_number": "12345678" }, "email": "john@yourdomain.com", "first_name": "Pilar", "last_name": "Palomo", "date_created": "", "authentication_type": "Facebook", "registration date": "2015-06-02T12:58:41.425-04:00", "is_prime_user": false, "is_first_purchase_online": false, "last_purchase": "2020-01-02T12:58:41.425-04:00" }, "payment_methods": { "excluded_payment_methods": [ { "id": "" } ], "default_installments": null, "default_payment_method_id": null, "excluded_payment_types": [ { "id": "" } ], "installments": null }, "shipments": { "mode": "not_specified", "receiver_address": { "zip_code": "52", "street_name": "German Schreiber Gulsmanco", "city_name": "San Isidro", "state_name": "Lima", "street_number": 1000 }, "express_shipment": false, "local_pickup": false } }'
Adicione qualquer informação extra que considerar necessária sobre:
- Itens (array
items)
Array items | Tipo | Descrição |
id | String | Código |
title | String | Nome |
category_id | String | Categoria |
quantity | Integer | Quantidade |
unit_price | Float | Preço unitário |
- Comprador (object
payer)
Object payer | Tipo | Descrição |
first_name | String | Nome |
last_name | String | Sobrenome |
identification | Object | Dados de identificação |
identification_type | String | Tipo de identificação |
identification_number | String | Número de identificação |
phone | Object | telefone |
area_code | Integer | Código de área |
number | Integer | Número de telefone |
address | Object | Dados do endereço |
zip_code | String | Código postal |
street_name | String | Nome da rua |
street_number | Integer | Número da rua |
authentication_type | Enum | Tipo de autenticação ("Gmail" - "Facebook" - "Web Nativa" - "Outro") |
registration_date | Date | Data de registro do comprador no site. |
is_prime_user | Boolean | True se é, False se não é. |
is_first_purchase_online | Boolean | True se é, False se não é. |
last_purchase | Date | Data da última compra no site. |
A seguir, você encontrará um exemplo de como enviar os dados apresentados nas tabelas acima:
curl
curl --location --request POST 'https://api.mercadopago.com/checkout/preferences' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \ --data-raw '{ "auto_return": "approved", "back_urls": { "failure": "https://www.mercadopago.com/home/failure", "pending": "https://www.mercadopago.com/home/pending", "success": "https://www.mercadopago.com/home/success" }, "notification_url": "https://webhook.site/xyz", "expires": false, "external_reference": "order-123", "date_of_expiration": "2025-03-12T12:58:41.425-04:00", "items": [ { "id": "1234", "currency_id": "PEN", "title": "Produto", "picture_url": "", "description": "Descrição de produto", "category_id": "services", "quantity": 1, "unit_price": 150 } ], "payer": { "phone": { "area_code": "11", "number": "643863703" }, "address": { "zip_code": "52", "street_name": "German Schreiber Gulsmanco", "street_number": 1000 }, "identification": { "identification_type": "RUC", "identification_number": "12345678" }, "email": "john@yourdomain.com", "name": "Pilar", "surname": "Palomo", "date_created": "", "authentication_type": "Facebook", "registration date": "2015-06-02T12:58:41.425-04:00", "is_prime_user": false, "is_first_purchase_online": false, "last_purchase": "2020-01-02T12:58:41.425-04:00" }, "payment_methods": { "excluded_payment_methods": [ { "id": "" } ], "default_installments": null, "default_payment_method_id": null, "excluded_payment_types": [ { "id": "" } ], "installments": null } }'
Adicione qualquer informação extra que considerar necessária sobre:
- Itens (array
items)
Array items | Tipo | Descrição |
id | String | Código |
title | String | Nome |
description | String | Descrição |
picture_url | String | Imagem URL |
category_id | String | Categoria |
quantity | Integer | Quantidade |
unit_price | Float | Preço unitário |
- Comprador (object
payer)
Object payer | Tipo | Descrição |
first_name | String | Nome |
last_name | String | Sobrenome |
identification | Object | Dados de identificação |
identification_type | String | Tipo de identificação |
identification_number | String | Número de identificação |
phone | Object | telefone |
area_code | Integer | Código de área |
number | Integer | Número de telefone |
address | Object | Dados do endereço |
zip_code | String | Código postal |
street_name | String | Nome da rua |
street_number | Integer | Número da rua |
authentication_type | Enum | Tipo de autenticação ("Gmail" - "Facebook" - "Web Nativa" - "Outro") |
registration_date | Date | Data de registro do comprador no site. |
is_prime_user | Boolean | True se é, False se não é. |
is_first_purchase_online | Boolean | True se é, False se não é. |
last_purchase | Date | Data da última compra no site. |
- Entregas (object
shipment)
Object shipment | Tipo | Descrição |
receiver_address | Object | Dados do endereço do comprador. |
zip_code | String | Código postal |
state_name | String | Província |
city_name | String | Cidade |
street_number | Integer | Número da rua |
express_shipment | Boolean | True se é, False se não é. |
A seguir, você encontrará um exemplo de como enviar os dados apresentados nas tabelas acima:
curl
curl --location --request POST 'https://api.mercadopago.com/checkout/preferences' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \ --data-raw '{ "auto_return": "approved", "back_urls": { "failure": "https://www.mercadopago.com/us/home/failure", "pending": "https://www.mercadopago.com/us/home/pending", "success": "https://www.mercadopago.com/us/home/success" }, "notification_url": "https://webhook.site/xyz", "expires": false, "external_reference": "order-123", "date_of_expiration": "2025-03-12T12:58:41.425-04:00", "items": [ { "id": "1234", "currency_id": "PEN", "title": "Produto", "picture_url": "", "description": "Descrição de produto", "category_id": "others", "quantity": 1, "unit_price": 150 } ], "payer": { "phone": { "area_code": "11", "number": "643863703" }, "address": { "zip_code": "52", "street_name": "German Schreiber Gulsmanco", "street_number": 1000 }, "identification": { "identification_type": "RUC", "identification_number": "12345678" }, "email": "john@yourdomain.com", "name": "Pilar", "surname": "Palomo", "date_created": "", "authentication_type": "Facebook", "registration date": "2015-06-02T12:58:41.425-04:00", "is_prime_user": false, "is_first_purchase_online": false, "last_purchase": "2020-01-02T12:58:41.425-04:00" }, "payment_methods": { "excluded_payment_methods": [ { "id": "" } ], "default_installments": null, "default_payment_method_id": null, "excluded_payment_types": [ { "id": "" } ], "installments": null }, "shipments": { "mode": "not_specified", "receiver_address": { "zip_code": "52", "street_name": "German Schreiber Gulsmanco", "city_name": "San Isidro", "state_name": "Lima", "street_number": 1000 }, "express_shipment": false, "local_pickup": false } }'
Adicione qualquer informação extra que considerar necessária sobre:
- Itens (array
items)
Array items | Tipo | Descrição |
id | String | Código |
title | String | Nome |
description | String | Descrição |
category_id | String | Categoria |
quantity | Integer | Quantidade |
unit_price | Float | Preço unitário |
category_descriptor | Object | Descrição da categoria |
event_date | Date | Data do evento |
- Comprador (object
payer)
Object payer | Tipo | Descrição |
first_name | String | Nome |
last_name | String | Sobrenome |
identification | Object | Dados de identificação |
identification_type | String | Tipo de identificação |
identification_number | String | Número de identificação |
phone | Object | telefone |
area_code | Integer | Código de área |
number | Integer | Número de telefone |
address | Object | Dados do endereço |
zip_code | String | Código postal |
street_name | String | Nome da rua |
street_number | Integer | Número da rua |
authentication_type | Enum | Tipo de autenticação ("Gmail" - "Facebook" - "Web Nativa" - "Outro") |
registration_date | Date | Data de registro do comprador no site. |
is_prime_user | Boolean | True se é, False se não é. |
is_first_purchase_online | Boolean | True se é, False se não é. |
last_purchase | Date | Data da última compra no site. |
- Entregas (object
shipment)
Object shipment | Tipo | Descrição |
receiver_address | Object | Dados do endereço do comprador. |
zip_code | String | Código postal |
state_name | String | Província |
city_name | String | Cidade |
street_number | Integer | Número da rua |
A seguir, você encontrará um exemplo de como enviar os dados apresentados nas tabelas acima:
curl
curl --location --request POST 'https://api.mercadopago.com/checkout/preferences' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \ --data-raw '{ "auto_return": "approved", "back_urls": { "failure": "https://www.mercadopago.com/home/failure", "pending": "https://www.mercadopago.com/home/pending", "success": "https://www.mercadopago.com/home/success" }, "notification_url": "https://webhook.site/xyz", "expires": false, "external_reference": "order-123", "date_of_expiration": "2025-03-12T12:58:41.425-04:00", "items": [ { "id": "1234", "currency_id": "PEN", "title": "Serviço", "picture_url": "", "description": "Descrição de serviço", "category_id": "services", "quantity": 1, "unit_price": 150, "category_descriptor":{ "event_date": "2022-03-12T12:58:41.425-04:00" }, } ], "payer": { "phone": { "area_code": "11", "number": "643863703" }, "address": { "zip_code": "52", "street_name": "German Schreiber Gulsmanco", "street_number": 1000 }, "identification": { "identification_type": "RUC", "identification_number": "12345678" }, "email": "john@yourdomain.com", "name": "Pilar", "surname": "Palomo", "date_created": "", "authentication_type": "Facebook", "registration date": "2015-06-02T12:58:41.425-04:00", "is_prime_user": false, "is_first_purchase_online": false, "last_purchase": "2020-01-02T12:58:41.425-04:00" }, "payment_methods": { "excluded_payment_methods": [ { "id": "" } ], "default_installments": null, "default_payment_method_id": null, "excluded_payment_types": [ { "id": "" } ], "installments": null }, "shipments": { "mode": "not_specified", "receiver_address": { "zip_code": "52", "street_name": "German Schreiber Gulsmanco", "city_name": "San Isidro", "state_name": "Lima", "street_number": 1000 } } }'
Adicione qualquer informação extra que considerar necessária sobre:
- Itens (array
items)
Array items | Tipo | Descrição |
id | String | Código |
title | String | Nome |
description | String | Descrição |
category_id | String | Categoria |
quantity | Integer | Quantidade |
unit_price | Float | Preço unitário |
category_descriptor | Object | Descrição de la categoría. |
passenger | Object | Informações adicionais sobre passageiros. |
first_name | String | Nome |
last_name | String | Sobrenome |
identification_type | String | Tipo de identificação |
identification_number | String | Número de identificação |
route | Object | Informações da rota |
departure | String | Saída |
destination | String | Chegada |
departure_date_time | Date | Data de saída. Exemplo: 2024-06-20T06:20:00.000-04:00. |
arrival_date_time | Date | Data de chegada |
company | String | Companhia |
- Comprador (object
payer)
Object payer | Tipo | Descrição |
first_name | String | Nome |
last_name | String | Sobrenome |
identification | Object | Dados de identificação |
identification_type | String | Tipo de identificação |
identification_number | String | Número de identificação |
phone | Object | telefone |
area_code | Integer | Código de área |
number | Integer | Número de telefone |
address | Object | Dados do endereço |
zip_code | String | Código postal |
street_name | String | Nome da rua |
street_number | Integer | Número da rua |
authentication_type | Enum | Tipo de autenticação ("Gmail" - "Facebook" - "Web Nativa" - "Outro") |
registration_date | Date | Data de registro do comprador no site. |
is_prime_user | Boolean | True se é, False se não é. |
is_first_purchase_online | Boolean | True se é, False se não é. |
last_purchase | Date | Data da última compra no site. |
A seguir, você encontrará um exemplo de como enviar os dados apresentados nas tabelas acima:
curl
curl --location --request POST 'https://api.mercadopago.com/checkout/preferences' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \ --data-raw '{ "auto_return": "approved", "back_urls": { "failure": "https://www.mercadopago.com/home/failure", "pending": "https://www.mercadopago.com/home/pending", "success": "https://www.mercadopago.com/home/success" }, "notification_url": "https://webhook.site/xyz", "expires": false, "external_reference": "order-123", "date_of_expiration": "2025-03-12T12:58:41.425-04:00", "items": [ { "id": "1234", "currency_id": "PEN", "title": "Serviço", "description": "Descrição de serviço", "category_id": "travels", "category_descriptor":{ "passenger": { "first_name": "Pilar", "last_name": "Palomo", "type": "RUC", "number": 12345678 }, "route": { "departure": "San Isidro", "destination": "Londres", "departure_date_time": "2022-03-12T12:58:41.425-04:00", "arrival_date_time": "2022-03-14T12:58:41.425-04:00", "company": "Compañía" } }, "quantity": 1, "unit_price": 150 } ], "payer": { "phone": { "area_code": "11", "number": "643863703" }, "address": { "zip_code": "52", "street_name": "German Schreiber Gulsmanco", "street_number": 1000 }, "identification": { "identification_type": "RUC", "identification_number": "12345678" }, "email": "john@yourdomain.com", "name": "Pilar", "surname": "Palomo", "date_created": "", "authentication_type": "Facebook", "registration date": "2015-06-02T12:58:41.425-04:00", "is_prime_user": false, "is_first_purchase_online": false, "last_purchase": "2020-01-02T12:58:41.425-04:00" }, "payment_methods": { "excluded_payment_methods": [ { "id": "" } ], "default_installments": null, "default_payment_method_id": null, "excluded_payment_types": [ { "id": "" } ], "installments": null } }'
Adicione qualquer informação extra que considerar necessária sobre:
- Itens (array
items)
Array items | Tipo | Descrição |
id | String | Código |
title | String | Nome |
category_id | String | Categoria |
quantity | Integer | Quantidade |
unit_price | Float | Preço unitário |
event_date | Date | Data do evento |
category_descriptor | Object | Descrição da categoria |
passenger | Object | Informações adicionais sobre passageiros |
first_name | String | Nome |
last_name | String | Sobrenome |
identification_type | String | Tipo de identificação |
identification_number | String | Número de identificação |
- Comprador (object
payer)
Object payer | Tipo | Descrição |
first_name | String | Nome |
last_name | String | Sobrenome |
identification | Object | Dados de identificação |
identification_type | String | Tipo de identificação |
identification_number | String | Número de identificação |
phone | Object | telefone |
area_code | Integer | Código de área |
number | Integer | Número de telefone |
address | Object | Dados do endereço |
zip_code | String | Código postal |
street_name | String | Nome da rua |
street_number | Integer | Número da rua |
authentication_type | Enum | Tipo de autenticação ("Gmail" - "Facebook" - "Web Nativa" - "Outro") |
registration_date | Date | Data de registro do comprador no site. |
is_prime_user | Boolean | True se é, False se não é. |
is_first_purchase_online | Boolean | True se é, False se não é. |
last_purchase | Date | Data da última compra no site. |
A seguir, você encontrará um exemplo de como enviar os dados apresentados nas tabelas acima:
curl
curl --location --request POST 'https://api.mercadopago.com/checkout/preferences' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \ --data-raw '{ "auto_return": "approved", "back_urls": { "failure": "https://www.mercadopago.com/home/failure", "pending": "https://www.mercadopago.com/home/pending", "success": "https://www.mercadopago.com/home/success" }, "notification_url": "https://webhook.site/xyz", "expires": false, "external_reference": "order-123", "date_of_expiration": "2025-03-12T12:58:41.425-04:00", "items": [ { "id": "1234", "currency_id": "PEN", "title": "Serviço", "description": "Descrição de serviço", "category_id": "travels", "category_descriptor": { "event_date": "2022-03-12T12:58:41.425-04:00" "passenger": { "first_name": "Pilar", "last_name": "Palomo", "type": "RUC", "number": 12345678 } }, "quantity": 1, "unit_price": 150 } ], "payer": { "phone": { "area_code": "11", "number": "643863703" }, "address": { "zip_code": "52", "street_name": "German Schreiber Gulsmanco", "street_number": 1000 }, "identification": { "identification_type": "RUC", "identification_number": "12345678" }, "email": "john@yourdomain.com", "name": "Pilar", "surname": "Palomo", "date_created": "", "authentication_type": "Facebook", "registration date": "2015-06-02T12:58:41.425-04:00", "is_prime_user": false, "is_first_purchase_online": false, "last_purchase": "2020-01-02T12:58:41.425-04:00" }, "payment_methods": { "excluded_payment_methods": [ { "id": "" } ], "default_installments": null, "default_payment_method_id": null, "excluded_payment_types": [ { "id": "" } ], "installments": null } }'
Adicione qualquer informação extra que considerar necessária sobre:
- Itens (array
items)
Array items | Tipo | Descrição |
id | String | Código |
title | String | Nome |
category_id | String | Categoria |
quantity | Integer | Quantidade |
unit_price | Float | Preço unitário |
- Comprador (object
payer)
Object payer | Tipo | Descrição |
first_name | String | Nome |
last_name | String | Sobrenome |
identification | Object | Dados de identificação |
identification_type | String | Tipo de identificação |
identification_number | String | Número de identificação |
phone | Object | telefone |
area_code | Integer | Código de área |
number | Integer | Número de telefone |
address | Object | Dados do endereço |
zip_code | String | Código postal |
street_name | String | Nome da rua |
street_number | Integer | Número da rua |
authentication_type | Enum | Tipo de autenticação ("Gmail" - "Facebook" - "Web Nativa" - "Outro") |
registration_date | Date | Data de registro do comprador no site. |
is_prime_user | Boolean | True se é, False se não é. |
is_first_purchase_online | Boolean | True se é, False se não é. |
last_purchase | Date | Data da última compra no site. |
A seguir, você encontrará um exemplo de como enviar os dados apresentados nas tabelas acima:
curl
curl --location --request POST 'https://api.mercadopago.com/checkout/preferences' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \ --data-raw '{ "auto_return": "approved", "back_urls": { "failure": "https://www.mercadopago.com/home/failure", "pending": "https://www.mercadopago.com/home/pending", "success": "https://www.mercadopago.com/home/success" }, "notification_url": "https://webhook.site/xyz", "expires": false, "external_reference": "order-123", "date_of_expiration": "2025-03-12T12:58:41.425-04:00", "items": [ { "id": "1234", "currency_id": "PEN", "title": "Produto", "picture_url": "", "category_id": "others", "quantity": 1, "unit_price": 150 } ], "payer": { "phone": { "area_code": "11", "number": "643863703" }, "address": { "zip_code": "52", "street_name": "German Schreiber Gulsmanco", "street_number": 1000 }, "identification": { "identification_type": "RUC", "identification_number": "12345678" }, "email": "john@yourdomain.com", "name": "Pilar", "surname": "Palomo", "date_created": "", "authentication_type": "Facebook", "registration date": "2015-06-02T12:58:41.425-04:00", "is_prime_user": false, "is_first_purchase_online": false, "last_purchase": "2020-01-02T12:58:41.425-04:00" }, "payment_methods": { "excluded_payment_methods": [ { "id": "" } ], "default_installments": null, "default_payment_method_id": null, "excluded_payment_types": [ { "id": "" } ], "installments": null } }'
Adicione qualquer informação extra que considerar necessária sobre:
- Itens (array
items)
Array items | Tipo | Descrição |
id | String | Código |
title | String | Nome |
description | String | Descrição |
category_id | String | Categoria |
quantity | Integer | Quantidade |
unit_price | Float | Preço unitário |
- Comprador (object
payer)
Object payer | Tipo | Descrição |
first_name | String | Nome |
last_name | String | Sobrenome |
identification | Object | Dados de identificação |
identification_type | String | Tipo de identificação |
identification_number | String | Número de identificação |
phone | Object | telefone |
area_code | Integer | Código de área |
number | Integer | Número de telefone |
address | Object | Dados do endereço |
zip_code | String | Código postal |
street_name | String | Nome da rua |
street_number | Integer | Número da rua |
authentication_type | Enum | Tipo de autenticação ("Gmail" - "Facebook" - "Web Nativa" - "Outro") |
registration_date | Date | Data de registro do comprador no site. |
is_prime_user | Boolean | True se é, False se não é. |
is_first_purchase_online | Boolean | True se é, False se não é. |
last_purchase | Date | Data da última compra no site. |
- Entregas (object
shipment)
Object shipment | Tipo | Descrição |
receiver_address | Object | Dados do endereço do comprador. |
zip_code | String | Código postal |
state_name | String | Província |
city_name | String | Cidade |
street_number | Integer | Número da rua |
floor | String | Piso |
apartment | String | Apartamento |
local_pickup | Boolean | True se retira na agência ou na loja, False se não retira. |
A seguir, você encontrará um exemplo de como enviar os dados apresentados nas tabelas acima:
curl
curl --location --request POST 'https://api.mercadopago.com/checkout/preferences' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \ --data-raw '{ "auto_return": "approved", "back_urls": { "failure": "https://www.mercadopago.com/home/failure", "pending": "https://www.mercadopago.com/home/pending", "success": "https://www.mercadopago.com/home/success" }, "notification_url": "https://webhook.site/xyz", "expires": false, "external_reference": "order-123", "date_of_expiration": "2025-03-12T12:58:41.425-04:00", "items": [ { "id": "1234", "currency_id": "PEN", "title": "Produto", "picture_url": "", "description": "Descrição de produto", "category_id": "others", "quantity": 1, "unit_price": 150 } ], "payer": { "phone": { "area_code": "11", "number": "643863703" }, "address": { "zip_code": "52", "street_name": "German Schreiber Gulsmanco", "street_number": 1000 }, "identification": { "identification_type": "RUC", "identification_number": "12345678" }, "email": "john@yourdomain.com", "name": "Pilar", "surname": "Palomo", "date_created": "", "authentication_type": "Facebook", "registration date": "2015-06-02T12:58:41.425-04:00", "is_prime_user": false, "is_first_purchase_online": false, "last_purchase": "2020-01-02T12:58:41.425-04:00" }, "payment_methods": { "excluded_payment_methods": [ { "id": "" } ], "default_installments": null, "default_payment_method_id": null, "excluded_payment_types": [ { "id": "" } ], "installments": null }, "shipments": { "mode": "not_specified", "local_pickup": false, "receiver_address": { "zip_code": "52", "street_name": "German Schreiber Gulsmanco", "city_name": "San Isidro", "state_name": "Lima", "street_number": 1000 "floor": "12", "apartment": "B" } } }'
Adicione qualquer informação extra que considerar necessária sobre:
- Itens (array
items)
Array items | Tipo | Descrição |
id | String | Código |
title | String | Nome |
description | String | Descrição |
category_id | String | Categoria |
quantity | Integer | Quantidade |
unit_price | Float | Preço unitário |
- Comprador (object
payer)
Object payer | Tipo | Descrição |
first_name | String | Nome |
last_name | String | Sobrenome |
identification | Object | Dados de identificação |
identification_type | String | Tipo de identificação |
identification_number | String | Número de identificação |
phone | Object | telefone |
area_code | Integer | Código de área |
number | Integer | Número de telefone |
address | Object | Dados do endereço |
zip_code | String | Código postal |
street_name | String | Nome da rua |
street_number | Integer | Número da rua |
authentication_type | Enum | Tipo de autenticação ("Gmail" - "Facebook" - "Web Nativa" - "Outro") |
registration_date | Date | Data de registro do comprador no site. |
is_first_purchase_online | Boolean | True se é, False se não é. |
last_purchase | Date | Data da última compra no site. |
- Entregas (object
shipment)
Object shipment | Tipo | Descrição |
receiver_address | Object | Dados do endereço do comprador. |
zip_code | String | Código postal |
state_name | String | Província |
city_name | String | Cidade |
street_number | Integer | Número da rua |
floor | String | Piso |
apartment | String | Apartamento |
local_pickup | Boolean | True se retira na agência ou na loja, False se não retira. |
A seguir, você encontrará um exemplo de como enviar os dados apresentados nas tabelas acima:
curl
curl --location --request POST 'https://api.mercadopago.com/checkout/preferences' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \ --data-raw '{ "auto_return": "approved", "back_urls": { "failure": "https://www.mercadopago.com/home/failure", "pending": "https://www.mercadopago.com/home/pending", "success": "https://www.mercadopago.com/home/success" }, "notification_url": "https://webhook.site/xyz", "expires": false, "external_reference": "order-123", "date_of_expiration": "2025-03-12T12:58:41.425-04:00", "items": [ { "id": "1234", "currency_id": "PEN", "title": "Produto", "picture_url": "", "description": "Descrição de produto", "category_id": "others", "quantity": 1, "unit_price": 150 } ], "payer": { "phone": { "area_code": "11", "number": "643863703" }, "address": { "zip_code": "52", "street_name": "German Schreiber Gulsmanco", "street_number": 1000 }, "identification": { "identification_type": "RUC", "identification_number": "12345678" }, "email": "john@yourdomain.com", "name": "Pilar", "surname": "Palomo", "date_created": "", "authentication_type": "Facebook", "registration date": "2015-06-02T12:58:41.425-04:00", "is_first_purchase_online": false, "last_purchase": "2020-01-02T12:58:41.425-04:00" }, "payment_methods": { "excluded_payment_methods": [ { "id": "" } ], "default_installments": null, "default_payment_method_id": null, "excluded_payment_types": [ { "id": "" } ], "installments": null }, "shipments": { "mode": "not_specified", "local_pickup": false, "receiver_address": { "zip_code": "52", "street_name": "German Schreiber Gulsmanco", "city_name": "San Isidro", "state_name": "Lima", "street_number": 1000 "floor": "12", "apartment": "B" } } }'
Adicione qualquer informação extra que considerar necessária sobre:
- Itens (array
items)
Array items | Tipo | Descrição |
id | String | Código |
title | String | Nome |
description | String | Descrição |
category_id | String | Categoria |
quantity | Integer | Quantidade |
unit_price | Float | Preço unitário |
- Comprador (object
payer)
Object payer | Tipo | Descrição |
first_name | String | Nome |
last_name | String | Sobrenome |
identification | Object | Dados de identificação |
identification_type | String | Tipo de identificação |
identification_number | String | Número de identificação |
phone | Object | telefone |
area_code | Integer | Código de área |
number | Integer | Número de telefone |
address | Object | Dados do endereço |
zip_code | String | Código postal |
street_name | String | Nome da rua |
street_number | Integer | Número da rua |
authentication_type | Enum | Tipo de autenticação ("Gmail" - "Facebook" - "Web Nativa" - "Outro") |
registration_date | Date | Data de registro do comprador no site. |
is_prime_user | Boolean | True se é, False se não é. |
is_first_purchase_online | Boolean | True se é, False se não é. |
last_purchase | Date | Data da última compra no site. |
A seguir, você encontrará um exemplo de como enviar os dados apresentados nas tabelas acima:
curl
curl --location --request POST 'https://api.mercadopago.com/checkout/preferences' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \ --data-raw '{ "auto_return": "approved", "back_urls": { "failure": "https://www.mercadopago.com/home/failure", "pending": "https://www.mercadopago.com/home/pending", "success": "https://www.mercadopago.com/home/success" }, "notification_url": "https://webhook.site/xyz", "expires": false, "external_reference": "order-123", "date_of_expiration": "2025-03-12T12:58:41.425-04:00", "items": [ { "id": "1234", "currency_id": "PEN", "title": "Produto", "picture_url": "", "description": "Descrição de produto", "category_id": "others", "quantity": 1, "unit_price": 150 } ], "payer": { "phone": { "area_code": "11", "number": "643863703" }, "address": { "zip_code": "52", "street_name": "German Schreiber Gulsmanco", "street_number": 1000 }, "identification": { "identification_type": "RUC", "identification_number": "12345678" }, "email": "john@yourdomain.com", "name": "Pilar", "surname": "Palomo", "date_created": "", "authentication_type": "Facebook", "registration date": "2015-06-02T12:58:41.425-04:00", "is_first_purchase_online": false, "is_prime_user": false, "last_purchase": "2020-01-02T12:58:41.425-04:00" }, "payment_methods": { "excluded_payment_methods": [ { "id": "" } ], "default_installments": null, "default_payment_method_id": null, "excluded_payment_types": [ { "id": "" } ], "installments": null } }'
Adicione qualquer informação extra que considerar necessária sobre:
- Itens (array
items)
Array items | Tipo | Descrição |
id | String | Código de identificação do item. |
title | String | Nome do item. |
warranty | Boolean | true se é, false se não é. |
category_id | String | Categoria do item. |
quantity | Integer | Quantidade de unidades do item. |
unit_price | Float | Preço unitário atribuído ao item. Pode ser um valor inteiro ou em casas decimais. |
- Comprador (object
payer)
Object payer | Tipo | Descrição |
first_name | String | Nome do comprador. |
last_name | String | Sobrenome do comprador. |
identification | Object | Dados de identificação do comprador. |
type | String | Tipo de identificação. Está dentro do objeto identification. |
number | String | Número de identificação. Está dentro do objeto identification. |
phone | Object | Telefone do comprador. |
area_code | Integer | Código de área do comprador. Está dentro do objeto phone. |
number | Integer | Número de telefone do comprador. Está dentro do objeto phone. |
address | Object | Dados do endereço do comprador. |
zip_code | String | Código postal do comprador. Está dentro do objeto address. |
street_name | String | Nome da rua do endereço do comprador. Está dentro do objeto address. |
street_number | Integer | Número da rua do endereço do comprador. Está dentro do objeto address. |
authentication_type | Enum | Tipo de autenticação. Pode ser "Gmail", "Facebook", "Web Nativa" ou "Outro". |
registration_date | Date | Data de registro do comprador no site. |
is_prime_user | Boolean | Indica se o usuário é premium. Caso seja, use true e, caso não seja, use false. |
is_first_purchase_online | Boolean | Indica se é a primeira compra do cliente. Caso seja, use true e, caso não seja, use false. |
last_purchase | Date | Data da última compra no site. |
A seguir, você encontrará um exemplo de como enviar os dados apresentados nas tabelas acima:
curl
curl --location 'https://api.mercadopago.com/checkout/preferences' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer {{access_token}}' \ --data-raw '{ "auto_return": "approved", "back_urls": { "failure": "https://www.mercadopago.com/home/failure", "pending": "https://www.mercadopago.com/home/pending", "success": "https://www.mercadopago.com/home/success" }, "notification_url": "https://webhook.site/xyz", "expires": false, "external_reference": "order-123", "date_of_expiration": "2026-03-12T12:58:41.425-04:00", "items": [ { "id": "1234", "currency_id": "MXN", "title": "Producto", "picture_url": "", "description": "Descripción de producto", "category_id": "lottery", "quantity": 1, "unit_price": 150 } ], "payer": { "phone": { "area_code": "11", "number": "619 911 306" }, "address": { "zip_code": "52", "street_name": "Insurgentes Sur", "street_number": 1000 }, "identification": { "identification_type": "-", "identification_number": "12345678" }, "email": "carlota.castellanos@yourdomain.com", "name": "Carlota", "surname": "Castellanos", "date_created": "", "authentication_type": "Facebook", "registration date": "2015-06-02T12:58:41.425-04:00", "is_first_purchase_online": false, "is_prime_user": false, "last_purchase": "2020-01-02T12:58:41.425-04:00" }, "payment_methods": { "excluded_payment_methods": [ { "id": "" } ], "default_installments": null, "default_payment_method_id": null, "excluded_payment_types": [ { "id": "" } ], "installments": null } }'