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": "PEN",
"title": "Product",
"picture_url": "",
"description": "Product Description",
"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
}
}'
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": "PEN",
"title": "Product",
"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
}
}'
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": "PEN",
"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": "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
}
}'
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": "PEN",
"title": "Product",
"picture_url": "",
"description": "Product Description",
"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
}
}'
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": "PEN",
"title": "Product",
"picture_url": "",
"description": "Product Description",
"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
}
}'
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": "PEN",
"title": "Product",
"picture_url": "",
"description": "Product Description",
"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
}
}'
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": "PEN",
"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": "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
}
}
}'
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": "PEN",
"title": "Service",
"description": "Service description",
"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": "Company"
}
},
"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
}
}'
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": "PEN",
"title": "Service",
"description": "Service description",
"category_id": "Travels",
"category_descriptor": {
"event_date": "2020-06-02T12: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
}
}'
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": "PEN",
"title": "Product",
"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
}
}'
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": "PEN",
"title": "Product",
"picture_url": "",
"description": "Product description",
"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"
}
}
}'
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": "PEN",
"title": "Product",
"picture_url": "",
"description": "Product Description",
"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"
}
}
}'
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": "PEN",
"title": "Product",
"picture_url": "",
"description": "Product Description",
"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
}
}'