Industry data
Check what fields you can submit according to your industry to improve your approval.
Apparel
Fields to send
Add all the additional information you want.
About items
Array items | Type | Description |
id | String | Code |
title | String | Name |
type | String | Type |
description | String | Description |
picture_url | String | Picture URL |
category_id | String | Category |
quantity | Integer | Quantity |
unit_price | Float | Unit price |
About the buyer
Object payer | Type | Description |
first_name | String | Name |
last_name | String | Surname |
identification | Object | Identification data |
identification_type | String | Identification type |
identification_number | String | Identification number |
phone | Object | Phone |
area_code | Integer | Area Code |
number | Integer | Phone number |
address | Object | Adress data |
zip_code | String | Postal code |
street_name | String | Street name |
street_number | Integer | Street number |
authentication_type | Enum | Authentication type ("Gmail" - "Facebook" - "Native web" - "Other") |
registration_date | Date | Buyer's registration date on the site. |
is_prime_user | Boolean | True if it is, False if it is not. |
is_first_purchase_online | Boolean | True if it is, False if it is not. |
last_purchase | Date | Date of the last purchase on the site. |
About shipments
Object shipment | Type | Description |
receiver_address | Object | Address of the buyer. |
zip_code | String | Postal code |
state_name | String | Province |
city_name | String | City |
street_number | Integer | Street number |
express_shipment | Boolean | True if it is, False if it is not. |
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": "BRL",
"title": "Product",
"picture_url": "",
"description": "Product Description",
"type": "test",
"category_id": "fashion",
"quantity": 1,
"unit_price": 150
}
],
"payer": {
"phone": {
"area_code": "11",
"number": "987654321"
},
"address": {
"zip_code": "52",
"street_name": "Av. das Nações Unidas",
"street_number": 1000
},
"identification": {
"identification_type": "CPF",
"identification_number": "12345678"
},
"email": "john@yourdomain.com",
"first_name": "Maria",
"last_name": "Silva",
"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": "Av. das Nações Unidas",
"city_name": "Osasco",
"state_name": "São Paulo",
"street_number": 1000
},
"express_shipment": false
}
}'
Electro
Fields to send
Add all the additional information you want.
About items
Array items | Type | Description |
id | String | Code |
title | String | Name |
category_id | String | Category |
quantity | Integer | Quantity |
unit_price | Float | Unit price |
warranty | Boolean | True if the product has a guarantee, False if it does not. |
About the buyer
Object payer | Type | Description |
first_name | String | Name |
last_name | String | Surname |
identification | Object | Identification data |
identification_type | String | Identification type |
identification_number | String | Identification number |
phone | Object | Phone |
area_code | Integer | Area Code |
number | Integer | Phone number |
address | Object | Adress data |
zip_code | String | Postal code |
street_name | String | Street name |
street_number | Integer | Street number |
authentication_type | Enum | Authentication type ("Gmail" - "Facebook" - "Native web" - "Other") |
registration_date | Date | Buyer's registration date on the site. |
is_prime_user | Boolean | True if it is, False if it is not. |
is_first_purchase_online | Boolean | True if it is, False if it is not. |
last_purchase | Date | Date of the last purchase on the site. |
About shipments
Object shipment | Type | Description |
local_pickup | Boolean | True if you withdraw in branch, False if you do not. |
receiver_address | Object | Address of the buyer. |
zip_code | String | Postal code |
state_name | String | Province |
city_name | String | City |
street_number | Integer | Street number |
express_shipment | Boolean | True if it is, False if it is not. |
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": "BRL",
"title": "Product",
"category_id": "phones",
"quantity": 1,
"unit_price": 150,
"warranty": false,
}
],
"payer": {
"phone": {
"area_code": "11",
"number": "987654321"
},
"address": {
"zip_code": "52",
"street_name": "Av. das Nações Unidas",
"street_number": 1000
},
"identification": {
"identification_type": "CPF",
"identification_number": "12345678"
},
"email": "john@yourdomain.com”,
"first_name": "Maria",
"last_name": "Silva",
"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": "Av. das Nações Unidas",
"city_name": "Osasco",
"state_name": "São Paulo",
"street_number": 1000
},
"express_shipment": false,
"local_pickup": false
}
}'
Entertainment
Fields to send
Add all the additional information you want.
About items
Array items | Type | Description |
id | String | Code |
title | String | Name |
category_id | String | Category |
quantity | Integer | Quantity |
unit_price | Float | Unit price |
category_descriptor | Object | Category description |
event_date | Date | Event date |
About the buyer
Object payer | Type | Description |
first_name | String | Name |
last_name | String | Surname |
identification | Object | Identification data |
identification_type | String | Identification type |
identification_number | String | Identification number |
phone | Object | Phone |
area_code | Integer | Area Code |
number | Integer | Phone number |
authentication_type | Enum | Authentication type ("Gmail" - "Facebook" - "Native web" - "Other") |
registration_date | Date | Buyer's registration date on the site. |
is_prime_user | Boolean | True if it is, False if it is not. |
is_first_purchase_online | Boolean | True if it is, False if it is not. |
last_purchase | Date | Date of the last purchase on the site. |
About shipments
Object shipment | Type | Description |
receiver_address | Object | Address of the buyer. |
zip_code | String | Postal code |
state_name | String | Province |
city_name | String | City |
street_number | Integer | Street number |
express_shipment | Boolean | True if it is, False if it is not. |
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": "BRL",
"title": "Product",
"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": "987654321"
},
"identification": {
"identification_type": "CPF",
"identification_number": "12345678"
},
"email": "john@yourdomain.com",
"first_name": "Maria",
"last_name": "Silva",
"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": "Av. das Nações Unidas",
"city_name": "Osasco",
"state_name": "São Paulo",
"street_number": 1000
},
"express_shipment": false,
"local_pickup": false
}
}'
Home & deco
Fields to send
Add all the additional information you want.
About items
Array items | Type | Description |
id | String | Code |
title | String | Name |
description | String | Description |
category_id | String | Category |
quantity | Integer | Quantity |
unit_price | Float | Unit price |
warranty | Boolean | True if the product has a guarantee, False if it does not. |
About the buyer
Object payer | Type | Description |
first_name | String | Name |
last_name | String | Surname |
identification | Object | Identification data |
identification_type | String | Identification type |
identification_number | String | Identification number |
phone | Object | Phone |
area_code | Integer | Area code |
number | Integer | Phone number |
address | Object | Adress data |
zip_code | String | Postal code |
street_name | String | Street name |
street_number | Integer | Street number |
authentication_type | Enum | Authentication type ("Gmail" - "Facebook" - "Native web" - "Other") |
registration_date | Date | Buyer's registration date on the site. |
is_prime_user | Boolean | True if it is, False if it is not. |
is_first_purchase_online | Boolean | True if it is, False if it is not. |
last_purchase | Date | Date of the last purchase on the site. |
About shipments
Object shipment | Type | Description |
receiver_address | Object | Address of the buyer. |
zip_code | String | Postal code |
state_name | String | Province |
city_name | String | City |
street_number | Integer | Street number |
express_shipment | Boolean | True if it is, False if it is not. |
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": "BRL",
"title": "Product",
"picture_url": "",
"description": "Product Description",
"category_id": "home",
"quantity": 1,
"unit_price": 150,
"warranty": false,
}
],
"payer": {
"phone": {
"area_code": "11",
"number": "987654321"
},
"address": {
"zip_code": "52",
"street_name": "Av. das Nações Unidas",
"street_number": 1000
},
"identification": {
"identification_type": "CPF",
"identification_number": "12345678"
},
"email": "john@yourdomain.com",
"first_name": "Maria",
"last_name": "Silva",
"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": "Av. das Nações Unidas",
"city_name": "Osasco",
"state_name": "São Paulo",
"street_number": 1000
},
"express_shipment": false,
"local_pickup": false
}
}'
Applications and online platforms
Fields to send
Add all the additional information you want.
About items
Array items | Type | Description |
id | String | Code |
title | String | Name |
category_id | String | Category |
quantity | Integer | Quantity |
unit_price | Float | Unit price |
About the buyer
Object payer | Type | Description |
first_name | String | Name |
last_name | String | Surname |
identification | Object | Identification data |
identification_type | String | Identification type |
identification_number | String | Identification number |
phone | Object | Phone |
area_code | Integer | Area code |
number | Integer | Phone number |
address | Object | Adress data |
zip_code | String | Postal code |
street_name | String | Street name |
street_number | Integer | Street number |
authentication_type | Enum | Authentication type ("Gmail" - "Facebook" - "Native web" - "Other") |
registration_date | Date | Buyer's registration date on the site. |
is_prime_user | Boolean | True if it is, False if it is not. |
is_first_purchase_online | Boolean | True if it is, False if it is not. |
last_purchase | Date | Date of the last purchase on the site. |
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": "BRL",
"title": "Product",
"picture_url": "",
"description": "Product Description",
"category_id": "services",
"quantity": 1,
"unit_price": 150
}
],
"payer": {
"phone": {
"area_code": "11",
"number": "987654321"
},
"address": {
"zip_code": "52",
"street_name": "Av. das Nações Unidas",
"street_number": 1000
},
"identification": {
"identification_type": "CPF",
"identification_number": "12345678"
},
"email": "john@yourdomain.com",
"name": "Maria",
"surname": "Silva",
"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
}
}'
Retail
Fields to send
Add all the additional information you want.
About items
Array items | Type | Description |
id | String | Code |
title | String | Name |
description | String | Description |
picture_url | String | Picture URL |
category_id | String | Category |
quantity | Integer | Quantity |
unit_price | Float | Unit price |
About the buyer
Object payer | Type | Description |
first_name | String | Name |
last_name | String | Surname |
identification | Object | Identification data |
identification_type | String | Identification type |
identification_number | String | Identification number |
phone | Object | Phone |
area_code | Integer | Area code |
number | Integer | Phone number |
address | Object | Adress data |
zip_code | String | Postal code |
street_name | String | Street name |
street_number | Integer | Street number |
authentication_type | Enum | Authentication type ("Gmail" - "Facebook" - "Native web" - "Other") |
registration_date | Date | Buyer's registration date on the site. |
is_prime_user | Boolean | True if it is, False if it is not. |
is_first_purchase_online | Boolean | True if it is, False if it is not. |
last_purchase | Date | Date of the last purchase on the site. |
About shipments
Object shipment | Type | Description |
receiver_address | Object | Address of the buyer. |
zip_code | String | Postal code |
state_name | String | Province |
city_name | String | City |
street_number | Integer | Street number |
express_shipment | Boolean | True if it is, False if it is not. |
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": "BRL",
"title": "Product",
"picture_url": "",
"description": "Product Description",
"category_id": "others",
"quantity": 1,
"unit_price": 150
}
],
"payer": {
"phone": {
"area_code": "11",
"number": "987654321"
},
"address": {
"zip_code": "52",
"street_name": "Av. das Nações Unidas",
"street_number": 1000
},
"identification": {
"identification_type": "CPF",
"identification_number": "12345678"
},
"email": "john@yourdomain.com",
"name": "Maria",
"surname": "Silva",
"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": "Av. das Nações Unidas",
"city_name": "Osasco",
"state_name": "São Paulo",
"street_number": 1000
},
"express_shipment": false,
"local_pickup": false
}
}'
Government and public services
Fields to send
Add all the additional information you want.
About items
Array items | Type | Description |
id | String | Code |
title | String | Name |
description | String | Description |
category_id | String | Category |
quantity | Integer | Quantity |
unit_price | Float | Unit price |
category_descriptor | Object | Category description |
event_date | Date | Event date |
About the buyer
Object payer | Type | Description |
first_name | String | Name |
last_name | String | Surname |
identification | Object | Identification data |
identification_type | String | Identification type |
identification_number | String | Identification number |
phone | Object | Phone |
area_code | Integer | Area code |
number | Integer | Phone number |
address | Object | Adress data |
zip_code | String | Postal code |
street_name | String | Street name |
street_number | Integer | Street number |
authentication_type | Enum | Authentication type ("Gmail" - "Facebook" - "Native web" - "Other") |
registration_date | Date | Buyer's registration date on the site. |
is_prime_user | Boolean | True if it is, False if it is not. |
is_first_purchase_online | Boolean | True if it is, False if it is not. |
last_purchase | Date | Date of the last purchase on the site. |
About shipments
Object shipment | Type | Description |
receiver_address | Object | Address of the buyer. |
zip_code | String | Postal code |
state_name | String | Province |
city_name | String | City |
street_number | Integer | Street number |
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": "BRL",
"title": "Service",
"picture_url": "",
"description": "Service description",
"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": "987654321"
},
"address": {
"zip_code": "52",
"street_name": "Av. das Nações Unidas",
"street_number": 1000
},
"identification": {
"identification_type": "CPF",
"identification_number": "12345678"
},
"email": "john@yourdomain.com",
"name": "Maria",
"surname": "Silva",
"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": "Av. das Nações Unidas",
"city_name": "Osasco",
"state_name": "São Paulo",
"street_number": 1000
}
}
}'
Tourism
Fields to send
Add all the additional information you want.
About items
Array items | Type | Description |
id | String | Code |
title | String | Name |
description | String | Description |
category_id | String | Category |
quantity | Integer | Quantity |
unit_price | Float | Unit price |
category_descriptor | Object | Category description. |
passenger | Object | Additional passenger information. |
first_name | String | Name |
last_name | String | Surname |
identification_type | String | Identification type |
identification_number | String | Identification number |
route | Object | Route information |
departure | String | Departure |
destination | String | Arrival |
departure_date_time | Date | Departure date. Example: 2024-06-20T06:20:00.000-04:00. |
arrival_date_time | Date | Arrival date |
company | String | Company |
About the buyer
Object payer | Type | Description |
first_name | String | Name |
last_name | String | Surname |
identification | Object | Identification data |
identification_type | String | Identification type |
identification_number | String | Identification number |
phone | Object | Phone |
area_code | Integer | Area code |
number | Integer | Phone number |
address | Object | Adress data |
zip_code | String | Postal code |
street_name | String | Street name |
street_number | Integer | Street number |
authentication_type | Enum | Authentication type ("Gmail" - "Facebook" - "Native web" - "Other") |
registration_date | Date | Buyer's registration date on the site. |
is_prime_user | Boolean | True if it is, False if it is not. |
is_first_purchase_online | Boolean | True if it is, False if it is not. |
last_purchase | Date | Date of the last purchase on the site. |
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": "BRL",
"title": "Service",
"description": "Service description",
"category_id": "Travels",
"category_descriptor":{
"passenger": {
"first_name": "Maria",
"last_name": "Silva",
"type": "CPF",
"number": 12345678
},
"route": {
"departure": "Osasco",
"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": "Company"
}
},
"quantity": 1,
"unit_price": 150
}
],
"payer": {
"phone": {
"area_code": "11",
"number": "987654321"
},
"address": {
"zip_code": "52",
"street_name": "Av. das Nações Unidas",
"street_number": 1000
},
"identification": {
"identification_type": "CPF",
"identification_number": "12345678"
},
"email": "john@yourdomain.com",
"name": "Maria",
"surname": "Silva",
"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
}
}'
Hospitality
Fields to send
Add all the additional information you want.
About items
Array items | Type | Description |
id | String | Code |
title | String | Name |
category_id | String | Category |
quantity | Integer | Quantity |
unit_price | Float | Unit price |
event_date | Date | Event date |
category_descriptor | Object | Category description |
passenger | Object | Additional passenger information |
first_name | String | Name |
last_name | String | Surname |
identification_type | String | Identification type |
identification_number | String | Identification number |
About the buyer
Object payer | Type | Description |
first_name | String | Name |
last_name | String | Surname |
identification | Object | Identification data |
identification_type | String | Identification type |
identification_number | String | Identification number |
phone | Object | Phone |
area_code | Integer | Area code |
number | Integer | Phone number |
address | Object | Adress data |
zip_code | String | Postal code |
street_name | String | Street name |
street_number | Integer | Street number |
authentication_type | Enum | Authentication type ("Gmail" - "Facebook" - "Native web" - "Other") |
registration_date | Date | Buyer's registration date on the site. |
is_prime_user | Boolean | True if it is, False if it is not. |
is_first_purchase_online | Boolean | True if it is, False if it is not. |
last_purchase | Date | Date of the last purchase on the site. |
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": "BRL",
"title": "Service",
"description": "Service description",
"category_id": "Travels",
"category_descriptor": {
"event_date": "2020-06-02T12:58:41.425-04:00",
"passenger": {
"first_name": "Maria",
"last_name": "Silva",
"type": "CPF",
"number": 12345678
}
},
"quantity": 1,
"unit_price": 150
}
],
"payer": {
"phone": {
"area_code": "11",
"number": "987654321"
},
"address": {
"zip_code": "52",
"street_name": "Av. das Nações Unidas",
"street_number": 1000
},
"identification": {
"identification_type": "CPF",
"identification_number": "12345678"
},
"email": "john@yourdomain.com",
"name": "Maria",
"surname": "Silva",
"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
}
}'
Utilities
Fields to send
Add all the additional information you want.
About items
Array items | Type | Description |
id | String | Code |
title | String | Name |
category_id | String | Category |
quantity | Integer | Quantity |
unit_price | Float | Unit price |
About the buyer
Object payer | Type | Description |
first_name | String | Name |
last_name | String | Surname |
identification | Object | Identification data |
identification_type | String | Identification type |
identification_number | String | Identification number |
phone | Object | Phone |
area_code | Integer | Area code |
number | Integer | Phone number |
address | Object | Adress data |
zip_code | String | Postal code |
street_name | String | Street name |
street_number | Integer | Street number |
authentication_type | Enum | Authentication type ("Gmail" - "Facebook" - "Native web" - "Other") |
registration_date | Date | Buyer's registration date on the site. |
is_prime_user | Boolean | True if it is, False if it is not. |
is_first_purchase_online | Boolean | True if it is, False if it is not. |
last_purchase | Date | Date of the last purchase on the site. |
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": "BRL",
"title": "Product",
"picture_url": "",
"category_id": "others",
"quantity": 1,
"unit_price": 150
}
],
"payer": {
"phone": {
"area_code": "11",
"number": "987654321"
},
"address": {
"zip_code": "52",
"street_name": "Av. das Nações Unidas",
"street_number": 1000
},
"identification": {
"identification_type": "CPF",
"identification_number": "12345678"
},
"email": "john@yourdomain.com",
"name": "Maria",
"surname": "Silva",
"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
}
}'
Direct sale
Fields to send
Add all the additional information you want.
About items
Array items | Type | Description |
id | String | Code |
title | String | Name |
description | String | Description |
category_id | String | Category |
quantity | Integer | Quantity |
unit_price | Float | Unit price |
About the buyer
Object payer | Type | Description |
first_name | String | Name |
last_name | String | Surname |
identification | Object | Identification data |
identification_type | String | Identification type |
identification_number | String | Identification number |
phone | Object | Phone |
area_code | Integer | Area code |
number | Integer | Phone number |
address | Object | Adress data |
zip_code | String | Postal code |
street_name | String | Street name |
street_number | Integer | Street number |
authentication_type | Enum | Authentication type ("Gmail" - "Facebook" - "Native web" - "Other") |
registration_date | Date | Buyer's registration date on the site. |
is_prime_user | Boolean | True if it is, False if it is not. |
is_first_purchase_online | Boolean | True if it is, False if it is not. |
last_purchase | Date | Date of the last purchase on the site. |
About shipments
Object shipment | Type | Description |
receiver_address | Object | Address of the buyer. |
zip_code | String | Postal code |
state_name | String | Province |
city_name | String | City |
street_number | Integer | Street number |
floor | String | Floor |
apartment | String | Apartament |
local_pickup | Boolean | True if withdrawn at branch, False if not. |
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": "BRL",
"title": "Product",
"picture_url": "",
"description": "Product description",
"category_id": "others",
"quantity": 1,
"unit_price": 150
}
],
"payer": {
"phone": {
"area_code": "11",
"number": "987654321"
},
"address": {
"zip_code": "52",
"street_name": "Av. das Nações Unidas",
"street_number": 1000
},
"identification": {
"identification_type": "CPF",
"identification_number": "12345678"
},
"email": "john@yourdomain.com",
"name": "Maria",
"surname": "Silva",
"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": "Av. das Nações Unidas",
"city_name": "Osasco",
"state_name": "São Paulo",
"street_number": 1000
"floor": "12",
"apartment": "B"
}
}
}'
Automobiles and nautical
Fields to send
Add all the additional information you want.
About items
Array items | Type | Description |
id | String | Code |
title | String | Name |
description | String | Description |
category_id | String | Category |
quantity | Integer | Quantity |
unit_price | Float | Unit price |
About the buyer
Object payer | Type | Description |
first_name | String | Name |
last_name | String | Surname |
identification | Object | Identification data |
identification_type | String | Identification type |
identification_number | String | Identification number |
phone | Object | Phone |
area_code | Integer | Area Code |
number | Integer | Phone number |
address | Object | Adress data |
zip_code | String | Postal code |
street_name | String | Street name |
street_number | Integer | Street number |
authentication_type | Enum | Authentication type ("Gmail" - "Facebook" - "Native web" - "Other") |
registration_date | Date | Buyer's registration date on the site. |
is_first_purchase_online | Boolean | True if it is, False if it is not. |
last_purchase | Date | Date of the last purchase on the site. |
About shipments
Object shipment | Type | Description |
receiver_address | Object | Address of the buyer. |
zip_code | String | Postal code |
state_name | String | Province |
city_name | String | City |
street_number | Integer | Street number |
floor | String | Floor |
apartment | String | Apartament |
local_pickup | Boolean | True if withdrawn at branch, False if not. |
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": "BRL",
"title": "Product",
"picture_url": "",
"description": "Product Description",
"category_id": "others",
"quantity": 1,
"unit_price": 150
}
],
"payer": {
"phone": {
"area_code": "11",
"number": "987654321"
},
"address": {
"zip_code": "52",
"street_name": "Av. das Nações Unidas",
"street_number": 1000
},
"identification": {
"identification_type": "CPF",
"identification_number": "12345678"
},
"email": "john@yourdomain.com",
"name": "Maria",
"surname": "Silva",
"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": "Av. das Nações Unidas",
"city_name": "Osasco",
"state_name": "São Paulo",
"street_number": 1000
"floor": "12",
"apartment": "B"
}
}
}'
Urban transport
Fields to send
Add all the additional information you want.
About items
Array items | Type | Description |
id | String | Code |
title | String | Name |
description | String | Description |
category_id | String | Category |
quantity | Integer | Quantity |
unit_price | Float | Unit price |
About the buyer
Object payer | Type | Description |
first_name | String | Name |
last_name | String | Surname |
identification | Object | Identification data |
identification_type | String | Identification type |
identification_number | String | Identification number |
phone | Object | Phone |
area_code | Integer | Area Code |
number | Integer | Phone number |
address | Object | Adress data |
zip_code | String | Postal code |
street_name | String | Street name |
street_number | Integer | Street number |
authentication_type | Enum | Authentication type ("Gmail" - "Facebook" - "Native web" - "Other") |
registration_date | Date | Buyer's registration date on the site. |
is_prime_user | Boolean | True if it is, False if it is not. |
is_first_purchase_online | Boolean | True if it is, False if it is not. |
last_purchase | Date | Date of the last purchase on the site. |
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": "BRL",
"title": "Product",
"picture_url": "",
"description": "Product Description",
"category_id": "others",
"quantity": 1,
"unit_price": 150
}
],
"payer": {
"phone": {
"area_code": "11",
"number": "987654321"
},
"address": {
"zip_code": "52",
"street_name": "Av. das Nações Unidas",
"street_number": 1000
},
"identification": {
"identification_type": "CPF",
"identification_number": "12345678"
},
"email": "john@yourdomain.com",
"name": "Maria",
"surname": "Silva",
"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
}
}'