Revisa que campos puedes enviar según tu industria para mejorar tu aprobación.
Atención
Esta información solo funciona para la API de Preferencias.
Agrega toda la información adicional que quieras.
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 |
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. |
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 --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": "UYU",
"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": "656971212"
},
"address": {
"zip_code": "52",
"street_name": "Av Libertador Lavalleja",
"street_number": 1000
},
"identification": {
"identification_type": "CI",
"identification_number": "12345678"
},
"email": "john@yourdomain.com",
"first_name": "MarĆa Eugenia",
"last_name": "ValentĆn",
"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 Libertador Lavalleja",
"city_name": "Montevideo",
"state_name": "Montevideo",
"street_number": 1000
},
"express_shipment": false
}
}'
Agrega toda la información adicional que quieras.
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. |
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. |
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 --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": "UYU",
"title": "Producto",
"category_id": "phones",
"quantity": 1,
"unit_price": 150,
"warranty": false,
}
],
"payer": {
"phone": {
"area_code": "11",
"number": "656971212"
},
"address": {
"zip_code": "52",
"street_name": "Av Libertador Lavalleja",
"street_number": 1000
},
"identification": {
"identification_type": "CI",
"identification_number": "12345678"
},
"email": "john@yourdomain.comā,
"first_name": "MarĆa Eugenia",
"last_name": "ValentĆn",
"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 Libertador Lavalleja",
"city_name": "Montevideo",
"state_name": "Montevideo",
"street_number": 1000
},
"express_shipment": false,
"local_pickup": false
}
}'
Agrega toda la información adicional que quieras.
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 |
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. |
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 --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": "UYU",
"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": "656971212"
},
"identification": {
"identification_type": "CI",
"identification_number": "12345678"
},
"email": "john@yourdomain.com",
"first_name": "MarĆa Eugenia",
"last_name": "ValentĆn",
"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 Libertador Lavalleja",
"city_name": "Montevideo",
"state_name": "Montevideo",
"street_number": 1000
},
"express_shipment": false,
"local_pickup": false
}
}'
Agrega toda la información adicional que quieras.
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. |
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. |
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 --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": "UYU",
"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": "656971212"
},
"address": {
"zip_code": "52",
"street_name": "Av Libertador Lavalleja",
"street_number": 1000
},
"identification": {
"identification_type": "CI",
"identification_number": "12345678"
},
"email": "john@yourdomain.com",
"first_name": "MarĆa Eugenia",
"last_name": "ValentĆn",
"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 Libertador Lavalleja",
"city_name": "Montevideo",
"state_name": "Montevideo",
"street_number": 1000
},
"express_shipment": false,
"local_pickup": false
}
}'
Agrega toda la información adicional que quieras.
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 |
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 --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": "UYU",
"title": "Producto",
"picture_url": "",
"description": "Descripción de producto",
"category_id": "services",
"quantity": 1,
"unit_price": 150
}
],
"payer": {
"phone": {
"area_code": "11",
"number": "656971212"
},
"address": {
"zip_code": "52",
"street_name": "Av Libertador Lavalleja",
"street_number": 1000
},
"identification": {
"identification_type": "CI",
"identification_number": "12345678"
},
"email": "john@yourdomain.com",
"name": "MarĆa Eugenia",
"surname": "ValentĆn",
"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
}
}'
Agrega toda la información adicional que quieras.
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 |
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. |
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 --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": "UYU",
"title": "Producto",
"picture_url": "",
"description": "Descripción de producto",
"category_id": "others",
"quantity": 1,
"unit_price": 150
}
],
"payer": {
"phone": {
"area_code": "11",
"number": "656971212"
},
"address": {
"zip_code": "52",
"street_name": "Av Libertador Lavalleja",
"street_number": 1000
},
"identification": {
"identification_type": "CI",
"identification_number": "12345678"
},
"email": "john@yourdomain.com",
"name": "MarĆa Eugenia",
"surname": "ValentĆn",
"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 Libertador Lavalleja",
"city_name": "Montevideo",
"state_name": "Montevideo",
"street_number": 1000
},
"express_shipment": false,
"local_pickup": false
}
}'
Gobierno y servicios pĆŗblicos
Agrega toda la información adicional que quieras.
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 |
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. |
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 --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": "UYU",
"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": "656971212"
},
"address": {
"zip_code": "52",
"street_name": "Av Libertador Lavalleja",
"street_number": 1000
},
"identification": {
"identification_type": "CI",
"identification_number": "12345678"
},
"email": "john@yourdomain.com",
"name": "MarĆa Eugenia",
"surname": "ValentĆn",
"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 Libertador Lavalleja",
"city_name": "Montevideo",
"state_name": "Montevideo",
"street_number": 1000
}
}
}'
Agrega toda la información adicional que quieras.
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 |
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 --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": "UYU",
"title": "Servicio",
"description": "Descripción de servicio",
"category_id": "Travels",
"category_descriptor":{
"passenger": {
"first_name": "MarĆa Eugenia",
"last_name": "ValentĆn",
"type": "CI",
"number": 12345678
},
"route": {
"departure": "Montevideo",
"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": "656971212"
},
"address": {
"zip_code": "52",
"street_name": "Av Libertador Lavalleja",
"street_number": 1000
},
"identification": {
"identification_type": "CI",
"identification_number": "12345678"
},
"email": "john@yourdomain.com",
"name": "MarĆa Eugenia",
"surname": "ValentĆn",
"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
}
}'
Agrega toda la información adicional que quieras.
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 |
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 --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": "UYU",
"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": "MarĆa Eugenia",
"last_name": "ValentĆn",
"type": "CI",
"number": 12345678
}
},
"quantity": 1,
"unit_price": 150
}
],
"payer": {
"phone": {
"area_code": "11",
"number": "656971212"
},
"address": {
"zip_code": "52",
"street_name": "Av Libertador Lavalleja",
"street_number": 1000
},
"identification": {
"identification_type": "CI",
"identification_number": "12345678"
},
"email": "john@yourdomain.com",
"name": "MarĆa Eugenia",
"surname": "ValentĆn",
"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
}
}'
Agrega toda la información adicional que quieras.
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 |
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 --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": "UYU",
"title": "Producto",
"picture_url": "",
"category_id": "others",
"quantity": 1,
"unit_price": 150
}
],
"payer": {
"phone": {
"area_code": "11",
"number": "656971212"
},
"address": {
"zip_code": "52",
"street_name": "Av Libertador Lavalleja",
"street_number": 1000
},
"identification": {
"identification_type": "CI",
"identification_number": "12345678"
},
"email": "john@yourdomain.com",
"name": "MarĆa Eugenia",
"surname": "ValentĆn",
"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
}
}'
Agrega toda la información adicional que quieras.
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 |
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. |
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 --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": "UYU",
"title": "Producto",
"picture_url": "",
"description": "Descripción de producto",
"category_id": "others",
"quantity": 1,
"unit_price": 150
}
],
"payer": {
"phone": {
"area_code": "11",
"number": "656971212"
},
"address": {
"zip_code": "52",
"street_name": "Av Libertador Lavalleja",
"street_number": 1000
},
"identification": {
"identification_type": "CI",
"identification_number": "12345678"
},
"email": "john@yourdomain.com",
"name": "MarĆa Eugenia",
"surname": "ValentĆn",
"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 Libertador Lavalleja",
"city_name": "Montevideo",
"state_name": "Montevideo",
"street_number": 1000
"floor": "12",
"apartment": "B"
}
}
}'
Agrega toda la información adicional que quieras.
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 |
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. |
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 --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": "UYU",
"title": "Producto",
"picture_url": "",
"description": "Descripción de producto",
"category_id": "others",
"quantity": 1,
"unit_price": 150
}
],
"payer": {
"phone": {
"area_code": "11",
"number": "656971212"
},
"address": {
"zip_code": "52",
"street_name": "Av Libertador Lavalleja",
"street_number": 1000
},
"identification": {
"identification_type": "CI",
"identification_number": "12345678"
},
"email": "john@yourdomain.com",
"name": "MarĆa Eugenia",
"surname": "ValentĆn",
"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 Libertador Lavalleja",
"city_name": "Montevideo",
"state_name": "Montevideo",
"street_number": 1000
"floor": "12",
"apartment": "B"
}
}
}'
Agrega toda la información adicional que quieras.
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 |
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 --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": "UYU",
"title": "Producto",
"picture_url": "",
"description": "Descripción de producto",
"category_id": "others",
"quantity": 1,
"unit_price": 150
}
],
"payer": {
"phone": {
"area_code": "11",
"number": "656971212"
},
"address": {
"zip_code": "52",
"street_name": "Av Libertador Lavalleja",
"street_number": 1000
},
"identification": {
"identification_type": "CI",
"identification_number": "12345678"
},
"email": "john@yourdomain.com",
"name": "MarĆa Eugenia",
"surname": "ValentĆn",
"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
}
}'
Estos son los datos especĆficos para la industria gambling que puedes agregar a tu integración para mejorar la aprobación de los pagos.
Array items | Tipo | Descripción |
id | String | Código de identificación del Ćtem. |
title | String | Nombre del Ćtem. |
warranty | Boolean | true si lo es, false si no lo es. |
category_id | String | CategorĆa del Ćtem. |
quantity | Integer | Cantidad de unidades para el Ćtem. |
unit_price | Float | Precio unitario asignado al Ćtem. Puede ser entero o con decimales. |
Object payer | Tipo | Descripción |
first_name | String | Nombre del comprador. |
last_name | String | Apellido del comprador. |
identification | Object | Datos de identificación del comprador. |
type | String | Tipo de identificación. Se encuentra dentro del objeto identification . |
number | String | Número de identificación. Se encuentra dentro del objeto identification . |
phone | Object | TelƩfono del comprador. |
area_code | Integer | Código de Ôrea del comprador. Se encuentra dentro del objeto phone . |
number | Integer | Número de teléfono del comprador. Se encuentra dentro del objeto phone . |
address | Object | Datos del domicilio del comprador. |
zip_code | String | Código postal del comprador. Se encuentra dentro del objeto address . |
street_name | String | Nombre de calle del domicilio del comprador. Se encuentra dentro del objeto address . |
street_number | Integer | NĆŗmero de calle del domicilio del comprador. Se encuentra dentro del objeto address . |
authentication_type | Enum | Tipo de autenticación. Pueden ser "Gmail", "Facebook", "Web Nativa" u "Otro". |
registration_date | Date | Fecha de registro del comprador en el sitio. |
is_prime_user | Boolean | Indica si el usuario es premium. Coloca true si lo es o false si no lo es. |
is_first_purchase_online | Boolean | Indica si es la primera compra del cliente. Coloca true si lo es o false si no lo es. |
last_purchase | Date | Fecha de la Ćŗltima compra en el sitio. |
curl --location 'https://api.mercadopago.com/checkout/preferences' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{access_token}}' \
--data-raw '{
"auto_return": "approved",
"back_urls": {
"failure": "https://www.mercadopago.com/home/failure",
"pending": "https://www.mercadopago.com/home/pending",
"success": "https://www.mercadopago.com/home/success"
},
"notification_url": "https://webhook.site/xyz",
"expires": false,
"external_reference": "order-123",
"date_of_expiration": "2026-03-12T12:58:41.425-04:00",
"items": [
{
"id": "1234",
"currency_id": "MXN",
"title": "Producto",
"picture_url": "",
"description": "Descripción de producto",
"category_id": "lottery",
"quantity": 1,
"unit_price": 150
}
],
"payer": {
"phone": {
"area_code": "11",
"number": "619 911 306"
},
"address": {
"zip_code": "52",
"street_name": "Insurgentes Sur",
"street_number": 1000
},
"identification": {
"identification_type": "-",
"identification_number": "12345678"
},
"email": "carlota.castellanos@yourdomain.com",
"name": "Carlota",
"surname": "Castellanos",
"date_created": "",
"authentication_type": "Facebook",
"registration date": "2015-06-02T12:58:41.425-04:00",
"is_first_purchase_online": false,
"is_prime_user": false,
"last_purchase": "2020-01-02T12:58:41.425-04:00"
},
"payment_methods": {
"excluded_payment_methods": [
{
"id": ""
}
],
"default_installments": null,
"default_payment_method_id": null,
"excluded_payment_types": [
{
"id": ""
}
],
"installments": null
}
}'