Datos sobre industrias
Revisa que campos puedes enviar según tu industria para mejorar tu aprobación.
Apparel
Campos a enviar
Agrega toda la información adicional que quieras.
Sobre los ítems
Array items | Tipo | Descripción |
id | String | Código |
title | String | Nombre |
type | String | Tipo |
description | String | Descripción |
picture_url | String | URL de imagen |
category_id | String | Categoría |
quantity | Integer | Cantidad |
unit_price | Float | Precio unitario |
Sobre el comprador
Object payer | Tipo | Descripción |
first_name | String | Nombre |
last_name | String | Apellido |
identification | Object | Datos de identificación |
identification_type | String | Tipo de identificación |
identification_number | String | Número de identificación |
phone | Object | Teléfono |
area_code | Integer | Código de área |
number | Integer | Número de teléfono |
address | Object | Datos de dirección |
zip_code | String | Código postal |
street_name | String | Nombre de calle |
street_number | Integer | Número de calle |
authentication_type | Enum | Tipo de autenticación ("Gmail" - "Facebook" - "Web Nativa" - "Otro") |
registration_date | Date | Fecha de registro del comprador en el sitio. |
is_prime_user | Boolean | True si lo es, False si no lo es. |
is_first_purchase_online | Boolean | True si lo es, False si no lo es. |
last_purchase | Date | Fecha de la última compra en el sitio. |
Sobre envíos
Object shipment | Tipo | Descripción |
receiver_address | Object | Datos de dirección del comprador. |
zip_code | String | Código postal |
state_name | String | Provincia |
city_name | String | Ciudad |
street_number | Integer | Número de calle |
express_shipment | Boolean | True si lo es, False si no lo es. |
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": "ARS",
"title": "Producto",
"picture_url": "",
"description": "Descripción de producto",
"type": "test",
"category_id": "fashion",
"quantity": 1,
"unit_price": 150
}
],
"payer": {
"phone": {
"area_code": "11",
"number": "632 231 354"
},
"address": {
"zip_code": "52",
"street_name": "Av Caseros",
"street_number": 1000
},
"identification": {
"identification_type": "DNI",
"identification_number": "12345678"
},
"email": "john@yourdomain.com",
"first_name": "Berta",
"last_name": "Parra",
"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 Caseros",
"city_name": "Parque Patricios",
"state_name": "CABA",
"street_number": 1000
},
"express_shipment": false
}
}'
Electro
Campos a enviar
Agrega toda la información adicional que quieras.
Sobre los ítems
Array items | Tipo | Descripción |
id | String | Código |
title | String | Nombre |
category_id | String | Categoría |
quantity | Integer | Cantidad |
unit_price | Float | Precio unitario |
warranty | Boolean | True si el producto tiene garantía, False si no la tiene. |
Sobre el comprador
Object payer | Tipo | Descripción |
first_name | String | Nombre |
last_name | String | Apellido |
identification | Object | Datos de identificación |
identification_type | String | Tipo de identificación |
identification_number | String | Número de identificación |
phone | Object | Teléfono |
area_code | Integer | Código de área |
number | Integer | Número de teléfono |
address | Object | Datos de dirección |
zip_code | String | Código postal |
street_name | String | Nombre de calle |
street_number | Integer | Número de calle |
authentication_type | Enum | Tipo de autenticación ("Gmail" - "Facebook" - "Web Nativa" - "Otro") |
registration_date | Date | Fecha de registro del comprador en el sitio. |
is_prime_user | Boolean | True si lo es, False si no lo es. |
is_first_purchase_online | Boolean | True si lo es, False si no lo es. |
last_purchase | Date | Fecha de la última compra en el sitio. |
Sobre envíos
Object shipment | Tipo | Descripción |
local_pickup | Boolean | True si retira en sucursal, False si no lo hace |
receiver_address | Object | Datos de dirección del comprador. |
zip_code | String | Código postal |
state_name | String | Provincia |
city_name | String | Ciudad |
street_number | Integer | Número de calle |
express_shipment | Boolean | True si lo es, False si no lo es. |
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": "ARS",
"title": "Producto",
"category_id": "phones",
"quantity": 1,
"unit_price": 150,
"warranty": false,
}
],
"payer": {
"phone": {
"area_code": "11",
"number": "632 231 354"
},
"address": {
"zip_code": "52",
"street_name": "Av Caseros",
"street_number": 1000
},
"identification": {
"identification_type": "DNI",
"identification_number": "12345678"
},
"email": "john@yourdomain.com”,
"first_name": "Berta",
"last_name": "Parra",
"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 Caseros",
"city_name": "Parque Patricios",
"state_name": "CABA",
"street_number": 1000
},
"express_shipment": false,
"local_pickup": false
}
}'
Entretenimiento
Campos a enviar
Agrega toda la información adicional que quieras.
Sobre los ítems
Array items | Tipo | Descripción |
id | String | Código |
title | String | Nombre |
category_id | String | Categoría |
quantity | Integer | Cantidad |
unit_price | Float | Precio unitario |
category_descriptor | Object | Descripción de la categoría |
event_date | Date | Fecha del evento |
Sobre el comprador
Object payer | Tipo | Descripción |
first_name | String | Nombre |
last_name | String | Apellido |
identification | Object | Datos de identificación |
identification_type | String | Tipo de identificación |
identification_number | String | Número de identificación |
phone | Object | Teléfono |
area_code | Integer | Código de área |
number | Integer | Número de teléfono |
authentication_type | Enum | Tipo de autenticación ("Gmail" - "Facebook" - "Web Nativa" - "Otro") |
registration_date | Date | Fecha de registro del comprador en el sitio. |
is_prime_user | Boolean | True si lo es, False si no lo es. |
is_first_purchase_online | Boolean | True si lo es, False si no lo es. |
last_purchase | Date | Fecha de la última compra en el sitio. |
Sobre envíos
Object shipment | Tipo | Descripción |
receiver_address | Object | Datos de dirección del comprador. |
zip_code | String | Código postal |
state_name | String | Provincia |
city_name | String | Ciudad |
street_number | Integer | Número de calle |
express_shipment | Boolean | True si lo es, False si no lo es. |
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": "ARS",
"title": "Producto",
"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": "632 231 354"
},
"identification": {
"identification_type": "DNI",
"identification_number": "12345678"
},
"email": "john@yourdomain.com",
"first_name": "Berta",
"last_name": "Parra",
"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 Caseros",
"city_name": "Parque Patricios",
"state_name": "CABA",
"street_number": 1000
},
"express_shipment": false,
"local_pickup": false
}
}'
Home & deco
Campos a enviar
Agrega toda la información adicional que quieras.
Sobre los ítems
Array items | Tipo | Descripción |
id | String | Código |
title | String | Nombre |
description | String | Descripción |
category_id | String | Categoría |
quantity | Integer | Cantidad |
unit_price | Float | Precio unitario |
warranty | Boolean | True si el producto tiene garantía, False si no la tiene. |
Sobre el comprador
Object payer | Tipo | Descripción |
first_name | String | Nombre |
last_name | String | Apellido |
identification | Object | Datos de identificación |
identification_type | String | Tipo de identificación |
identification_number | String | Número de identificación |
phone | Object | Teléfono |
area_code | Integer | Código de área |
number | Integer | Número de teléfono |
address | Object | Datos de dirección |
zip_code | String | Código postal |
street_name | String | Nombre de calle |
street_number | Integer | Número de calle |
authentication_type | Enum | Tipo de autenticación ("Gmail" - "Facebook" - "Web Nativa" - "Otro") |
registration_date | Date | Fecha de registro del comprador en el sitio. |
is_prime_user | Boolean | True si lo es, False si no lo es. |
is_first_purchase_online | Boolean | True si lo es, False si no lo es. |
last_purchase | Date | Fecha de la última compra en el sitio. |
Sobre envíos
Object shipment | Tipo | Descripción |
receiver_address | Object | Datos de dirección del comprador. |
zip_code | String | Código postal |
state_name | String | Provincia |
city_name | String | Ciudad |
street_number | Integer | Número de calle |
express_shipment | Boolean | True si lo es, False si no lo es. |
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": "ARS",
"title": "Producto",
"picture_url": "",
"description": "Descripción de producto",
"category_id": "home",
"quantity": 1,
"unit_price": 150,
"warranty": false,
}
],
"payer": {
"phone": {
"area_code": "11",
"number": "632 231 354"
},
"address": {
"zip_code": "52",
"street_name": "Av Caseros",
"street_number": 1000
},
"identification": {
"identification_type": "DNI",
"identification_number": "12345678"
},
"email": "john@yourdomain.com",
"first_name": "Berta",
"last_name": "Parra",
"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 Caseros",
"city_name": "Parque Patricios",
"state_name": "CABA",
"street_number": 1000
},
"express_shipment": false,
"local_pickup": false
}
}'
Aplicaciones y plataformas online
Campos a enviar
Agrega toda la información adicional que quieras.
Sobre los ítems
Array items | Tipo | Descripción |
id | String | Código |
title | String | Nombre |
category_id | String | Categoría |
quantity | Integer | Cantidad |
unit_price | Float | Precio unitario |
Sobre el comprador
Object payer | Tipo | Descripción |
first_name | String | Nombre |
last_name | String | Apellido |
identification | Object | Datos de identificación |
identification_type | String | Tipo de identificación |
identification_number | String | Número de identificación |
phone | Object | Teléfono |
area_code | Integer | Código de área |
number | Integer | Número de teléfono |
address | Object | Datos de dirección |
zip_code | String | Código postal |
street_name | String | Nombre de calle |
street_number | Integer | Número de calle |
authentication_type | Enum | Tipo de autenticación ("Gmail" - "Facebook" - "Web Nativa" - "Otro") |
registration_date | Date | Fecha de registro del comprador en el sitio. |
is_prime_user | Boolean | True si lo es, False si no lo es. |
is_first_purchase_online | Boolean | True si lo es, False si no lo es. |
last_purchase | Date | Fecha de la última compra en el sitio. |
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": "ARS",
"title": "Producto",
"picture_url": "",
"description": "Descripción de producto",
"category_id": "services",
"quantity": 1,
"unit_price": 150
}
],
"payer": {
"phone": {
"area_code": "11",
"number": "632 231 354"
},
"address": {
"zip_code": "52",
"street_name": "Av Caseros",
"street_number": 1000
},
"identification": {
"identification_type": "DNI",
"identification_number": "12345678"
},
"email": "john@yourdomain.com",
"name": "Berta",
"surname": "Parra",
"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
Campos a enviar
Agrega toda la información adicional que quieras.
Sobre los ítems
Array items | Tipo | Descripción |
id | String | Código |
title | String | Nombre |
description | String | Descripción |
picture_url | String | URL de imagen |
category_id | String | Categoría |
quantity | Integer | Cantidad |
unit_price | Float | Precio unitario |
Sobre el comprador
Object payer | Tipo | Descripción |
first_name | String | Nombre |
last_name | String | Apellido |
identification | Object | Datos de identificación |
identification_type | String | Tipo de identificación |
identification_number | String | Número de identificación |
phone | Object | Teléfono |
area_code | Integer | Código de área |
number | Integer | Número de teléfono |
address | Object | Datos de dirección |
zip_code | String | Código postal |
street_name | String | Nombre de calle |
street_number | Integer | Número de calle |
authentication_type | Enum | Tipo de autenticación ("Gmail" - "Facebook" - "Web Nativa" - "Otro") |
registration_date | Date | Fecha de registro del comprador en el sitio. |
is_prime_user | Boolean | True si lo es, False si no lo es. |
is_first_purchase_online | Boolean | True si lo es, False si no lo es. |
last_purchase | Date | Fecha de la última compra en el sitio. |
Sobre envíos
Object shipment | Tipo | Descripción |
receiver_address | Object | Datos de dirección del comprador. |
zip_code | String | Código postal |
state_name | String | Provincia |
city_name | String | Ciudad |
street_number | Integer | Número de calle |
express_shipment | Boolean | True si lo es, False si no lo es. |
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": "ARS",
"title": "Producto",
"picture_url": "",
"description": "Descripción de producto",
"category_id": "others",
"quantity": 1,
"unit_price": 150
}
],
"payer": {
"phone": {
"area_code": "11",
"number": "632 231 354"
},
"address": {
"zip_code": "52",
"street_name": "Av Caseros",
"street_number": 1000
},
"identification": {
"identification_type": "DNI",
"identification_number": "12345678"
},
"email": "john@yourdomain.com",
"name": "Berta",
"surname": "Parra",
"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 Caseros",
"city_name": "Parque Patricios",
"state_name": "CABA",
"street_number": 1000
},
"express_shipment": false,
"local_pickup": false
}
}'
Gobierno y servicios públicos
Campos a enviar
Agrega toda la información adicional que quieras.
Sobre los ítems
Array items | Tipo | Descripción |
id | String | Código |
title | String | Nombre |
description | String | Descripción |
category_id | String | Categoría |
quantity | Integer | Cantidad |
unit_price | Float | Precio unitario |
category_descriptor | Object | Descripción de la categoría |
event_date | Date | Fecha del evento |
Sobre el comprador
Object payer | Tipo | Descripción |
first_name | String | Nombre |
last_name | String | Apellido |
identification | Object | Datos de identificación |
identification_type | String | Tipo de identificación |
identification_number | String | Número de identificación |
phone | Object | Teléfono |
area_code | Integer | Código de área |
number | Integer | Número de teléfono |
address | Object | Datos de dirección |
zip_code | String | Código postal |
street_name | String | Nombre de calle |
street_number | Integer | Número de calle |
authentication_type | Enum | Tipo de autenticación ("Gmail" - "Facebook" - "Web Nativa" - "Otro") |
registration_date | Date | Fecha de registro del comprador en el sitio. |
is_prime_user | Boolean | True si lo es, False si no lo es. |
is_first_purchase_online | Boolean | True si lo es, False si no lo es. |
last_purchase | Date | Fecha de la última compra en el sitio. |
Sobre envíos
Object shipment | Tipo | Descripción |
receiver_address | Object | Datos de dirección del comprador. |
zip_code | String | Código postal |
state_name | String | Provincia |
city_name | String | Ciudad |
street_number | Integer | Número de calle |
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": "ARS",
"title": "Servicio",
"picture_url": "",
"description": "Descripción de servicio",
"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": "632 231 354"
},
"address": {
"zip_code": "52",
"street_name": "Av Caseros",
"street_number": 1000
},
"identification": {
"identification_type": "DNI",
"identification_number": "12345678"
},
"email": "john@yourdomain.com",
"name": "Berta",
"surname": "Parra",
"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 Caseros",
"city_name": "Parque Patricios",
"state_name": "CABA",
"street_number": 1000
}
}
}'
Turismo
Campos a enviar
Agrega toda la información adicional que quieras.
Sobre los ítems
Array items | Tipo | Descripción |
id | String | Código |
title | String | Nombre |
description | String | Descripción |
category_id | String | Categoría |
quantity | Integer | Cantidad |
unit_price | Float | Precio unitario |
category_descriptor | Object | Descripción de la categoría. |
passenger | Object | Información adicional del pasajero. |
first_name | String | Nombre |
last_name | String | Apellido |
identification_type | String | Tipo de identificación |
identification_number | String | Número de identificación |
route | Object | Información de la ruta |
departure | String | Salida |
destination | String | Llegada |
departure_date_time | Date | Fecha de salida. Ejemplo: 2024-06-20T06:20:00.000-04:00. |
arrival_date_time | Date | Fecha de llegada |
company | String | Compañía |
Sobre el comprador
Object payer | Tipo | Descripción |
first_name | String | Nombre |
last_name | String | Apellido |
identification | Object | Datos de identificación |
identification_type | String | Tipo de identificación |
identification_number | String | Número de identificación |
phone | Object | Teléfono |
area_code | Integer | Código de área |
number | Integer | Número de teléfono |
address | Object | Datos de dirección |
zip_code | String | Código postal |
street_name | String | Nombre de calle |
street_number | Integer | Número de calle |
authentication_type | Enum | Tipo de autenticación ("Gmail" - "Facebook" - "Web Nativa" - "Otro") |
registration_date | Date | Fecha de registro del comprador en el sitio. |
is_prime_user | Boolean | True si lo es, False si no lo es. |
is_first_purchase_online | Boolean | True si lo es, False si no lo es. |
last_purchase | Date | Fecha de la última compra en el sitio. |
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": "ARS",
"title": "Servicio",
"description": "Descripción de servicio",
"category_id": "Travels",
"category_descriptor":{
"passenger": {
"first_name": "Berta",
"last_name": "Parra",
"type": "DNI",
"number": 12345678
},
"route": {
"departure": "Parque Patricios",
"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": "632 231 354"
},
"address": {
"zip_code": "52",
"street_name": "Av Caseros",
"street_number": 1000
},
"identification": {
"identification_type": "DNI",
"identification_number": "12345678"
},
"email": "john@yourdomain.com",
"name": "Berta",
"surname": "Parra",
"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
}
}'
Hotelería
Campos a enviar
Agrega toda la información adicional que quieras.
Sobre los ítems
Array items | Tipo | Descripción |
id | String | Código |
title | String | Nombre |
category_id | String | Categoría |
quantity | Integer | Cantidad |
unit_price | Float | Precio unitario |
event_date | Date | Fecha del evento |
category_descriptor | Object | Descripción de la categoría. |
passenger | Object | Información adicional del pasajero. |
first_name | String | Nombre |
last_name | String | Apellido |
identification_type | String | Tipo de identificación |
identification_number | String | Número de identificación |
Sobre el comprador
Object payer | Tipo | Descripción |
first_name | String | Nombre |
last_name | String | Apellido |
identification | Object | Datos de identificación |
identification_type | String | Tipo de identificación |
identification_number | String | Número de identificación |
phone | Object | Teléfono |
area_code | Integer | Código de área |
number | Integer | Número de teléfono |
address | Object | Datos de dirección |
zip_code | String | Código postal |
street_name | String | Nombre de calle |
street_number | Integer | Número de calle |
authentication_type | Enum | Tipo de autenticación ("Gmail" - "Facebook" - "Web Nativa" - "Otro") |
registration_date | Date | Fecha de registro del comprador en el sitio. |
is_prime_user | Boolean | True si lo es, False si no lo es. |
is_first_purchase_online | Boolean | True si lo es, False si no lo es. |
last_purchase | Date | Fecha de la última compra en el sitio. |
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": "ARS",
"title": "Servicio",
"description": "Descripción de servicio",
"category_id": "Travels",
"category_descriptor": {
"event_date": "2020-06-02T12:58:41.425-04:00",
"passenger": {
"first_name": "Berta",
"last_name": "Parra",
"type": "DNI",
"number": 12345678
}
},
"quantity": 1,
"unit_price": 150
}
],
"payer": {
"phone": {
"area_code": "11",
"number": "632 231 354"
},
"address": {
"zip_code": "52",
"street_name": "Av Caseros",
"street_number": 1000
},
"identification": {
"identification_type": "DNI",
"identification_number": "12345678"
},
"email": "john@yourdomain.com",
"name": "Berta",
"surname": "Parra",
"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
Campos a enviar
Agrega toda la información adicional que quieras.
Sobre los ítems
Array items | Tipo | Descripción |
id | String | Código |
title | String | Nombre |
category_id | String | Categoría |
quantity | Integer | Cantidad |
unit_price | Float | Precio unitario |
Sobre el comprador
Object payer | Tipo | Descripción |
first_name | String | Nombre |
last_name | String | Apellido |
identification | Object | Datos de identificación |
identification_type | String | Tipo de identificación |
identification_number | String | Número de identificación |
phone | Object | Teléfono |
area_code | Integer | Código de área |
number | Integer | Número de teléfono |
address | Object | Datos de dirección |
zip_code | String | Código postal |
street_name | String | Nombre de calle |
street_number | Integer | Número de calle |
authentication_type | Enum | Tipo de autenticación ("Gmail" - "Facebook" - "Web Nativa" - "Otro") |
registration_date | Date | Fecha de registro del comprador en el sitio. |
is_prime_user | Boolean | True si lo es, False si no lo es. |
is_first_purchase_online | Boolean | True si lo es, False si no lo es. |
last_purchase | Date | Fecha de la última compra en el sitio. |
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": "ARS",
"title": "Producto",
"picture_url": "",
"category_id": "others",
"quantity": 1,
"unit_price": 150
}
],
"payer": {
"phone": {
"area_code": "11",
"number": "632 231 354"
},
"address": {
"zip_code": "52",
"street_name": "Av Caseros",
"street_number": 1000
},
"identification": {
"identification_type": "DNI",
"identification_number": "12345678"
},
"email": "john@yourdomain.com",
"name": "Berta",
"surname": "Parra",
"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
}
}'
Venta directa
Campos a enviar
Agrega toda la información adicional que quieras.
Sobre los ítems
Array items | Tipo | Descripción |
id | String | Código |
title | String | Nombre |
description | String | Descripción |
category_id | String | Categoría |
quantity | Integer | Cantidad |
unit_price | Float | Precio unitario |
Sobre el comprador
Object payer | Tipo | Descripción |
first_name | String | Nombre |
last_name | String | Apellido |
identification | Object | Datos de identificación |
identification_type | String | Tipo de identificación |
identification_number | String | Número de identificación |
phone | Object | Teléfono |
area_code | Integer | Código de área |
number | Integer | Número de teléfono |
address | Object | Datos de dirección |
zip_code | String | Código postal |
street_name | String | Nombre de calle |
street_number | Integer | Número de calle |
authentication_type | Enum | Tipo de autenticación ("Gmail" - "Facebook" - "Web Nativa" - "Otro") |
registration_date | Date | Fecha de registro del comprador en el sitio. |
is_prime_user | Boolean | True si lo es, False si no lo es. |
is_first_purchase_online | Boolean | True si lo es, False si no lo es. |
last_purchase | Date | Fecha de la última compra en el sitio. |
Sobre envíos
Object shipment | Tipo | Descripción |
receiver_address | Object | Datos de dirección del comprador. |
zip_code | String | Código postal |
state_name | String | Provincia |
city_name | String | Ciudad |
street_number | Integer | Número de calle |
floor | String | Piso |
apartment | String | Apartamento |
local_pickup | Boolean | True si se retira en sucursal, False si no lo hace. |
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": "ARS",
"title": "Producto",
"picture_url": "",
"description": "Descripción de producto",
"category_id": "others",
"quantity": 1,
"unit_price": 150
}
],
"payer": {
"phone": {
"area_code": "11",
"number": "632 231 354"
},
"address": {
"zip_code": "52",
"street_name": "Av Caseros",
"street_number": 1000
},
"identification": {
"identification_type": "DNI",
"identification_number": "12345678"
},
"email": "john@yourdomain.com",
"name": "Berta",
"surname": "Parra",
"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 Caseros",
"city_name": "Parque Patricios",
"state_name": "CABA",
"street_number": 1000
"floor": "12",
"apartment": "B"
}
}
}'
Automóviles y náuticas
Campos a enviar
Agrega toda la información adicional que quieras.
Sobre los ítems
Array items | Tipo | Descripción |
id | String | Código |
title | String | Nombre |
description | String | Descripción |
category_id | String | Categoría |
quantity | Integer | Cantidad |
unit_price | Float | Precio unitario |
Sobre el comprador
Object payer | Tipo | Descripción |
first_name | String | Nombre |
last_name | String | Apellido |
identification | Object | Datos de identificación |
identification_type | String | Tipo de identificación |
identification_number | String | Número de identificación |
phone | Object | Teléfono |
area_code | Integer | Código de área |
number | Integer | Número de teléfono |
address | Object | Datos de dirección |
zip_code | String | Código postal |
street_name | String | Nombre de calle |
street_number | Integer | Número de calle |
authentication_type | Enum | Tipo de autenticación ("Gmail" - "Facebook" - "Web Nativa" - "Otro") |
registration_date | Date | Fecha de registro del comprador en el sitio. |
is_first_purchase_online | Boolean | True si lo es, False si no lo es. |
last_purchase | Date | Fecha de la última compra en el sitio. |
Sobre envíos
Object shipment | Tipo | Descripción |
receiver_address | Object | Datos de dirección del comprador. |
zip_code | String | Código postal |
state_name | String | Provincia |
city_name | String | Ciudad |
street_number | Integer | Número de calle |
floor | String | Piso |
apartment | String | Apartamento |
local_pickup | Boolean | True si se retira en sucursal, False si no lo hace. |
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": "ARS",
"title": "Producto",
"picture_url": "",
"description": "Descripción de producto",
"category_id": "others",
"quantity": 1,
"unit_price": 150
}
],
"payer": {
"phone": {
"area_code": "11",
"number": "632 231 354"
},
"address": {
"zip_code": "52",
"street_name": "Av Caseros",
"street_number": 1000
},
"identification": {
"identification_type": "DNI",
"identification_number": "12345678"
},
"email": "john@yourdomain.com",
"name": "Berta",
"surname": "Parra",
"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 Caseros",
"city_name": "Parque Patricios",
"state_name": "CABA",
"street_number": 1000
"floor": "12",
"apartment": "B"
}
}
}'
Transporte urbano
Campos a enviar
Agrega toda la información adicional que quieras.
Sobre los ítems
Array items | Tipo | Descripción |
id | String | Código |
title | String | Nombre |
description | String | Descripción |
category_id | String | Categoría |
quantity | Integer | Cantidad |
unit_price | Float | Precio unitario |
Sobre el comprador
Object payer | Tipo | Descripción |
first_name | String | Nombre |
last_name | String | Apellido |
identification | Object | Datos de identificación |
identification_type | String | Tipo de identificación |
identification_number | String | Número de identificación |
phone | Object | Teléfono |
area_code | Integer | Código de área |
number | Integer | Número de teléfono |
address | Object | Datos de dirección |
zip_code | String | Código postal |
street_name | String | Nombre de calle |
street_number | Integer | Número de calle |
authentication_type | Enum | Tipo de autenticación ("Gmail" - "Facebook" - "Web Nativa" - "Otro") |
registration_date | Date | Fecha de registro del comprador en el sitio. |
is_prime_user | Boolean | True si lo es, False si no lo es. |
is_first_purchase_online | Boolean | True si lo es, False si no lo es. |
last_purchase | Date | Fecha de la última compra en el sitio. |
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": "ARS",
"title": "Producto",
"picture_url": "",
"description": "Descripción de producto",
"category_id": "others",
"quantity": 1,
"unit_price": 150
}
],
"payer": {
"phone": {
"area_code": "11",
"number": "632 231 354"
},
"address": {
"zip_code": "52",
"street_name": "Av Caseros",
"street_number": 1000
},
"identification": {
"identification_type": "DNI",
"identification_number": "12345678"
},
"email": "john@yourdomain.com",
"name": "Berta",
"surname": "Parra",
"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
}
}'