Datos de industria - Checkout Pro - Mercado Pago Developers

Búsqueda inteligente powered by OpenAI

Datos sobre industrias

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.

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 --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": "CLP",
            "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": "679 789 318"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av. Apoquindo",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "RUT",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "first_name": "Carolina",
        "last_name": "Ponce",
        "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. Apoquindo",
            "city_name": "Las Condes",
            "state_name": "Santiago de Chile",
            "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 --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": "CLP",
            "title": "Producto",
            "category_id": "phones",
            "quantity": 1,
            "unit_price": 150,
            "warranty": false,
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "679 789 318"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av. Apoquindo",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "RUT",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com”,
        "first_name": "Carolina",
        "last_name": "Ponce",
        "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. Apoquindo",
            "city_name": "Las Condes",
            "state_name": "Santiago de Chile",
            "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 --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": "CLP",
            "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": "679 789 318"
        },
        "identification": {
          "identification_type": "RUT",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "first_name": "Carolina",
        "last_name": "Ponce",
        "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. Apoquindo",
            "city_name": "Las Condes",
            "state_name": "Santiago de Chile",
            "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 --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": "CLP",
            "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": "679 789 318"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av. Apoquindo",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "RUT",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "first_name": "Carolina",
        "last_name": "Ponce",
        "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. Apoquindo",
            "city_name": "Las Condes",
            "state_name": "Santiago de Chile",
            "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 --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": "CLP",
            "title": "Producto",
            "picture_url": "",
            "description": "Descripción de producto",
            "category_id": "services",
            "quantity": 1,
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "679 789 318"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av. Apoquindo",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "RUT",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Carolina",
        "surname": "Ponce",
        "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 --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": "CLP",
            "title": "Producto",
            "picture_url": "",
            "description": "Descripción de producto",
            "category_id": "others",
            "quantity": 1,
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "679 789 318"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av. Apoquindo",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "RUT",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Carolina",
        "surname": "Ponce",
        "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. Apoquindo",
            "city_name": "Las Condes",
            "state_name": "Santiago de Chile",
            "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 --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": "CLP",
            "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": "679 789 318"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av. Apoquindo",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "RUT",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Carolina",
        "surname": "Ponce",
        "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. Apoquindo",
            "city_name": "Las Condes",
            "state_name": "Santiago de Chile",
            "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 --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": "CLP",
            "title": "Servicio",
            "description": "Descripción de servicio",
            "category_id": "Travels",
            "category_descriptor":{
             "passenger": {
                 "first_name": "Carolina",
                  "last_name": "Ponce",
                   "type": "RUT",
                   "number": 12345678
              },
              "route": {
            	 "departure": "Las Condes",
            	 "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": "679 789 318"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av. Apoquindo",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "RUT",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Carolina",
        "surname": "Ponce",
        "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 --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": "CLP",
            "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": "Carolina",
                    "last_name": "Ponce",
                    "type": "RUT",
                    "number": 12345678
                }
            },
            "quantity": 1,
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "679 789 318"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av. Apoquindo",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "RUT",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Carolina",
        "surname": "Ponce",
        "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 --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": "CLP",
            "title": "Producto",
            "picture_url": "",
            "category_id": "others",
            "quantity": 1,
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "679 789 318"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av. Apoquindo",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "RUT",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Carolina",
        "surname": "Ponce",
        "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 --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": "CLP",
            "title": "Producto",
            "picture_url": "",
            "description": "Descripción de producto",
            "category_id": "others",
            "quantity": 1,
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "679 789 318"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av. Apoquindo",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "RUT",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Carolina",
        "surname": "Ponce",
        "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. Apoquindo",
            "city_name": "Las Condes",
            "state_name": "Santiago de Chile",
            "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 --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": "CLP",
            "title": "Producto",
            "picture_url": "",
            "description": "Descripción de producto",
            "category_id": "others",
            "quantity": 1,
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "679 789 318"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av. Apoquindo",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "RUT",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Carolina",
        "surname": "Ponce",
        "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. Apoquindo",
            "city_name": "Las Condes",
            "state_name": "Santiago de Chile",
            "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 --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": "CLP",
            "title": "Producto",
            "picture_url": "",
            "description": "Descripción de producto",
            "category_id": "others",
            "quantity": 1,
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "679 789 318"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av. Apoquindo",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "RUT",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Carolina",
        "surname": "Ponce",
        "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
    }
}'

Reembolsos y cancelaciones

Conoce las instrucciones necesarias para realizar un reembolso total, parcial y cancelar una compra en su sitio web.

Consideraciones sobre el IVA en Colombia

Conozca algunas consideraciones sobre el IVA en Colombia.

Documentación

¿Comenzando ahora?

Recursos

Soporte

Comunidad

Datos sobre industrias

Apparel

Campos a enviar

Sobre los ítems

Sobre el comprador

Sobre envíos

Electro

Campos a enviar

Sobre los ítems

Sobre el comprador

Sobre envíos

Entretenimiento

Campos a enviar

Sobre los ítems

Sobre el comprador

Sobre envíos

Home & deco

Campos a enviar

Sobre los ítems

Sobre el comprador

Sobre envíos

Aplicaciones y plataformas online

Campos a enviar

Sobre los ítems

Sobre el comprador

Retail

Campos a enviar

Sobre los ítems

Sobre el comprador

Sobre envíos

Gobierno y servicios públicos

Campos a enviar

Sobre los ítems

Sobre el comprador

Sobre envíos

Turismo

Campos a enviar

Sobre los ítems

Sobre el comprador

Hotelería

Campos a enviar

Sobre los ítems

Sobre el comprador

Utilities

Campos a enviar

Sobre los ítems

Sobre el comprador

Venta directa

Campos a enviar

Sobre los ítems

Sobre el comprador

Sobre envíos

Automóviles y náuticas

Campos a enviar

Sobre los ítems

Sobre el comprador

Sobre envíos

Transporte urbano

Campos a enviar

Sobre los ítems

Sobre el comprador

Navegación

Recursos y Comunidad

Mercado Pago

País e idioma