Developers
Referencia de API
Soporte
Ingresar

    Inicio

    Empieza por aquí

    Cobros online

    Checkout Pro

    Checkout API

    Link de pago

    Suscripciones

    Marketplace

    Mobile Checkout

    Web Tokenize Checkout

    Pagos presenciales

    Código QR

    Mercado Pago Point

    Plugins y plataformas

    WooCommerce

    Prestashop

    Magento 2

    Shopify

    Tiendanube

    VTEX

    SDKs

    Notificaciones

    Webhooks

    IPN

    Gestión de cuenta

    Requisitos para ir a producción

    Obtener pagos

    Reportes

    Devoluciones y cancelaciones

    Gestión de contracargos

    Mejora la aprobación

    Recursos

    Localización

    Changelog

    Status

EN ESTA PÁGINA

Sugiere cambios
Ayúdanos a mejorar la documentación
¿Viste información errónea, te gustaría que expliquemos algo más o que mejoremos nuestras guías? Déjanos tus sugerencias en GitHub.

Datos sobre industrias

Revisa que campos puedes enviar según tu industria para mejorar tu aprobación.

Apparel

Campos a enviar

Agrega toda la información adicional que quieras.

Sobre los ítems

Array itemsTipoDescripción
idStringCódigo
titleStringNombre
typeStringTipo
descriptionStringDescripción
picture_urlStringURL de imagen
category_idStringCategoría
quantityIntegerCantidad
unit_priceFloatPrecio unitario

Sobre el comprador

Object payerTipoDescripción
first_nameStringNombre
last_nameStringApellido
identificationObjectDatos de identificación
identification_typeStringTipo de identificación
identification_numberStringNúmero de identificación
phoneObjectTeléfono
area_codeIntegerCódigo de área
numberIntegerNúmero de teléfono
addressObjectDatos de dirección
zip_codeStringCódigo postal
street_nameStringNombre de calle
street_numberIntegerNúmero de calle
authentication_typeEnumTipo de autenticación ("Gmail" - "Facebook" - "Web Nativa" - "Otro")
registration_dateDateFecha de registro del comprador en el sitio.
is_prime_userBooleanTrue si lo es, False si no lo es.
is_first_purchase_onlineBooleanTrue si lo es, False si no lo es.
last_purchaseDateFecha de la última compra en el sitio.

Sobre envíos

Object shipmentTipoDescripción
receiver_addressObjectDatos de dirección del comprador.
zip_codeStringCódigo postal
state_nameStringProvincia
city_nameStringCiudad
street_numberIntegerNúmero de calle
express_shipmentBooleanTrue si lo es, False si no lo es.

curl

curl --location --request POST 'https://api.mercadopago.com/checkout/preferences' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data-raw '{
    "auto_return": "approved",
    "back_urls": {
        "failure": "https://www.mercadopago.com/home/failure",
        "pending": "https://www.mercadopago.com/home/pending",
        "success": "https://www.mercadopago.com/home/success"
    },
    "notification_url": "https://webhook.site/xyz",
    "expires": false,
    "external_reference": "order-123",
    "date_of_expiration": "2025-03-12T12:58:41.425-04:00",
    "items": [
        {
            "id": "1234",
            "currency_id": "ARS",
            "title": "Producto",
            "picture_url": "",
            "description": "Descripción de producto",
            "type": "test",
            "category_id": "fashion",
            "quantity": 1,
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "632 231 354"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av Caseros",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "DNI",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "first_name": "Berta",
        "last_name": "Parra",
        "date_created": "",
        "authentication_type": "Facebook",
        "registration date": "2015-06-02T12:58:41.425-04:00",
        "is_prime_user": false,
        "is_first_purchase_online": false,
        "last_purchase": "2020-01-02T12:58:41.425-04:00"
    },
    "payment_methods": {
        "excluded_payment_methods": [
            {
                "id": ""
            }
        ],
        "default_installments": null,
        "default_payment_method_id": null,
        "excluded_payment_types": [
            {
                "id": ""
            }
        ],
        "installments": null
    },
    "shipments": {
        "mode": "not_specified",
        "receiver_address": {
            "zip_code": "52",
            "street_name": "Av Caseros",
            "city_name": "Parque Patricios",
            "state_name": "CABA",
            "street_number": 1000
        },
        "express_shipment": false
    }
}'

Electro

Campos a enviar

Agrega toda la información adicional que quieras.

Sobre los ítems

Array itemsTipoDescripción
idStringCódigo
titleStringNombre
category_idStringCategoría
quantityIntegerCantidad
unit_priceFloatPrecio unitario
warrantyBooleanTrue si el producto tiene garantía, False si no la tiene.

Sobre el comprador

Object payerTipoDescripción
first_nameStringNombre
last_nameStringApellido
identificationObjectDatos de identificación
identification_typeStringTipo de identificación
identification_numberStringNúmero de identificación
phoneObjectTeléfono
area_codeIntegerCódigo de área
numberIntegerNúmero de teléfono
addressObjectDatos de dirección
zip_codeStringCódigo postal
street_nameStringNombre de calle
street_numberIntegerNúmero de calle
authentication_typeEnumTipo de autenticación ("Gmail" - "Facebook" - "Web Nativa" - "Otro")
registration_dateDateFecha de registro del comprador en el sitio.
is_prime_userBooleanTrue si lo es, False si no lo es.
is_first_purchase_onlineBooleanTrue si lo es, False si no lo es.
last_purchaseDateFecha de la última compra en el sitio.

Sobre envíos

Object shipmentTipoDescripción
local_pickupBooleanTrue si retira en sucursal, False si no lo hace
receiver_addressObjectDatos de dirección del comprador.
zip_codeStringCódigo postal
state_nameStringProvincia
city_nameStringCiudad
street_numberIntegerNúmero de calle
express_shipmentBooleanTrue si lo es, False si no lo es.

curl

curl --location --request POST 'https://api.mercadopago.com/checkout/preferences' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data-raw '{
    "auto_return": "approved",
    "back_urls": {
        "failure": "https://www.mercadopago.com/home/failure",
        "pending": "https://www.mercadopago.com/home/pending",
        "success": "https://www.mercadopago.com/home/success"
    },
    "notification_url": "https://webhook.site/xyz",
    "expires": false,
    "external_reference": "order-123",
    "date_of_expiration": "2025-03-12T12:58:41.425-04:00",
    "items": [
        {
            "id": "1234",
            "currency_id": "ARS",
            "title": "Producto",
            "category_id": "phones",
            "quantity": 1,
            "unit_price": 150,
            "warranty": false,
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "632 231 354"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av Caseros",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "DNI",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com”,
        "first_name": "Berta",
        "last_name": "Parra",
        "date_created": "",
        "authentication_type": "Facebook",
        "registration date": "2015-06-02T12:58:41.425-04:00",
        "is_prime_user": false,
        "is_first_purchase_online": false,
        "last_purchase": "2020-01-02T12:58:41.425-04:00"
    },
    "payment_methods": {
        "excluded_payment_methods": [
            {
                "id": ""
            }
        ],
        "default_installments": null,
        "default_payment_method_id": null,
        "excluded_payment_types": [
            {
                "id": ""
            }
        ],
        "installments": null
    },
    "shipments": {
        "mode": "not_specified",
        "receiver_address": {
            "zip_code": "52",
            "street_name": "Av Caseros",
            "city_name": "Parque Patricios",
            "state_name": "CABA",
            "street_number": 1000
        },
        "express_shipment": false,
        "local_pickup": false
    }
}'

Entretenimiento

Campos a enviar

Agrega toda la información adicional que quieras.

Sobre los ítems

Array itemsTipoDescripción
idStringCódigo
titleStringNombre
category_idStringCategoría
quantityIntegerCantidad
unit_priceFloatPrecio unitario
event_dateDateFecha del evento

Sobre el comprador

Object payerTipoDescripción
first_nameStringNombre
last_nameStringApellido
identificationObjectDatos de identificación
identification_typeStringTipo de identificación
identification_numberStringNúmero de identificación
phoneObjectTeléfono
area_codeIntegerCódigo de área
numberIntegerNúmero de teléfono
authentication_typeEnumTipo de autenticación ("Gmail" - "Facebook" - "Web Nativa" - "Otro")
registration_dateDateFecha de registro del comprador en el sitio.
is_prime_userBooleanTrue si lo es, False si no lo es.
is_first_purchase_onlineBooleanTrue si lo es, False si no lo es.
last_purchaseDateFecha de la última compra en el sitio.

Sobre envíos

Object shipmentTipoDescripción
receiver_addressObjectDatos de dirección del comprador.
zip_codeStringCódigo postal
state_nameStringProvincia
city_nameStringCiudad
street_numberIntegerNúmero de calle
express_shipmentBooleanTrue si lo es, False si no lo es.

curl

curl --location --request POST 'https://api.mercadopago.com/checkout/preferences' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data-raw '{
    "auto_return": "approved",
    "back_urls": {
        "failure": "https://www.mercadopago.com/home/failure",
        "pending": "https://www.mercadopago.com/home/pending",
        "success": "https://www.mercadopago.com/home/success"
    },
    "notification_url": "https://webhook.site/xyz",
    "expires": false,
    "external_reference": "order-123",
    "date_of_expiration": "2025-03-12T12:58:41.425-04:00",
    "items": [
        {
            "id": "1234",
            "currency_id": "ARS",
            "title": "Producto",
            "category_id": "entertainment",
            "quantity": 1,
            "unit_price": 150,
            "event_date": "2020-06-02T12:58:41.425-04:00",
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "632 231 354"
        },
        "identification": {
          "identification_type": "DNI",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "first_name": "Berta",
        "last_name": "Parra",
        "date_created": "",
        "authentication_type": "Facebook",
        "registration date": "2015-06-02T12:58:41.425-04:00",
        "is_prime_user": false,
        "is_first_purchase_online": false,
        "last_purchase": "2020-01-02T12:58:41.425-04:00"
    },
    "payment_methods": {
        "excluded_payment_methods": [
            {
                "id": ""
            }
        ],
        "default_installments": null,
        "default_payment_method_id": null,
        "excluded_payment_types": [
            {
                "id": ""
            }
        ],
        "installments": null
    },
    "shipments": {
        "mode": "not_specified",
        "receiver_address": {
            "zip_code": "52",
            "street_name": "Av Caseros",
            "city_name": "Parque Patricios",
            "state_name": "CABA",
            "street_number": 1000
        },
        "express_shipment": false,
        "local_pickup": false
    }
}'

Home & deco

Campos a enviar

Agrega toda la información adicional que quieras.

Sobre los ítems

Array itemsTipoDescripción
idStringCódigo
titleStringNombre
descriptionStringDescripción
category_idStringCategoría
quantityIntegerCantidad
unit_priceFloatPrecio unitario
warrantyBooleanTrue si el producto tiene garantía, False si no la tiene.

Sobre el comprador

Object payerTipoDescripción
first_nameStringNombre
last_nameStringApellido
identificationObjectDatos de identificación
identification_typeStringTipo de identificación
identification_numberStringNúmero de identificación
phoneObjectTeléfono
area_codeIntegerCódigo de área
numberIntegerNúmero de teléfono
addressObjectDatos de dirección
zip_codeStringCódigo postal
street_nameStringNombre de calle
street_numberIntegerNúmero de calle
authentication_typeEnumTipo de autenticación ("Gmail" - "Facebook" - "Web Nativa" - "Otro")
registration_dateDateFecha de registro del comprador en el sitio.
is_prime_userBooleanTrue si lo es, False si no lo es.
is_first_purchase_onlineBooleanTrue si lo es, False si no lo es.
last_purchaseDateFecha de la última compra en el sitio.

Sobre envíos

Object shipmentTipoDescripción
receiver_addressObjectDatos de dirección del comprador.
zip_codeStringCódigo postal
state_nameStringProvincia
city_nameStringCiudad
street_numberIntegerNúmero de calle
express_shipmentBooleanTrue si lo es, False si no lo es.

curl

curl --location --request POST 'https://api.mercadopago.com/checkout/preferences' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data-raw '{
    "auto_return": "approved",
    "back_urls": {
        "failure": "https://www.mercadopago.com/home/failure",
        "pending": "https://www.mercadopago.com/home/pending",
        "success": "https://www.mercadopago.com/home/success"
    },
    "notification_url": "https://webhook.site/xyz",
    "expires": false,
    "external_reference": "order-123",
    "date_of_expiration": "2025-03-12T12:58:41.425-04:00",
    "items": [
        {
            "id": "1234",
            "currency_id": "ARS",
            "title": "Producto",
            "picture_url": "",
            "description": "Descripción de producto",
            "category_id": "home",
            "quantity": 1,
            "unit_price": 150,
            "warranty": false,
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "632 231 354"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av Caseros",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "DNI",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "first_name": "Berta",
        "last_name": "Parra",
        "date_created": "",
        "authentication_type": "Facebook",
        "registration date": "2015-06-02T12:58:41.425-04:00",
        "is_prime_user": false,
        "is_first_purchase_online": false,
        "last_purchase": "2020-01-02T12:58:41.425-04:00"
    },
    "payment_methods": {
        "excluded_payment_methods": [
            {
                "id": ""
            }
        ],
        "default_installments": null,
        "default_payment_method_id": null,
        "excluded_payment_types": [
            {
                "id": ""
            }
        ],
        "installments": null
    },
    "shipments": {
        "mode": "not_specified",
        "receiver_address": {
            "zip_code": "52",
            "street_name": "Av Caseros",
            "city_name": "Parque Patricios",
            "state_name": "CABA",
            "street_number": 1000
        },
        "express_shipment": false,
        "local_pickup": false
    }
}'

Aplicaciones y plataformas online

Campos a enviar

Agrega toda la información adicional que quieras.

Sobre los ítems

Array itemsTipoDescripción
idStringCódigo
titleStringNombre
category_idStringCategoría
quantityIntegerCantidad
unit_priceFloatPrecio unitario

Sobre el comprador

Object payerTipoDescripción
first_nameStringNombre
last_nameStringApellido
identificationObjectDatos de identificación
identification_typeStringTipo de identificación
identification_numberStringNúmero de identificación
phoneObjectTeléfono
area_codeIntegerCódigo de área
numberIntegerNúmero de teléfono
addressObjectDatos de dirección
zip_codeStringCódigo postal
street_nameStringNombre de calle
street_numberIntegerNúmero de calle
authentication_typeEnumTipo de autenticación ("Gmail" - "Facebook" - "Web Nativa" - "Otro")
registration_dateDateFecha de registro del comprador en el sitio.
is_prime_userBooleanTrue si lo es, False si no lo es.
is_first_purchase_onlineBooleanTrue si lo es, False si no lo es.
last_purchaseDateFecha de la última compra en el sitio.

curl

curl --location --request POST 'https://api.mercadopago.com/checkout/preferences' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data-raw '{
    "auto_return": "approved",
    "back_urls": {
        "failure": "https://www.mercadopago.com/home/failure",
        "pending": "https://www.mercadopago.com/home/pending",
        "success": "https://www.mercadopago.com/home/success"
    },
    "notification_url": "https://webhook.site/xyz",
    "expires": false,
    "external_reference": "order-123",
    "date_of_expiration": "2025-03-12T12:58:41.425-04:00",
    "items": [
        {
            "id": "1234",
            "currency_id": "ARS",
            "title": "Producto",
            "picture_url": "",
            "description": "Descripción de producto",
            "category_id": "services",
            "quantity": 1,
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "632 231 354"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av Caseros",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "DNI",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Berta",
        "surname": "Parra",
        "date_created": "",
        "authentication_type": "Facebook",
        "registration date": "2015-06-02T12:58:41.425-04:00",
        "is_prime_user": false,
        "is_first_purchase_online": false,
        "last_purchase": "2020-01-02T12:58:41.425-04:00"
    },
    "payment_methods": {
        "excluded_payment_methods": [
            {
                "id": ""
            }
        ],
        "default_installments": null,
        "default_payment_method_id": null,
        "excluded_payment_types": [
            {
                "id": ""
            }
        ],
        "installments": null
    }
}'

Retail

Campos a enviar

Agrega toda la información adicional que quieras.

Sobre los ítems

Array itemsTipoDescripción
idStringCódigo
titleStringNombre
descriptionStringDescripción
picture_urlStringURL de imagen
category_idStringCategoría
quantityIntegerCantidad
unit_priceFloatPrecio unitario

Sobre el comprador

Object payerTipoDescripción
first_nameStringNombre
last_nameStringApellido
identificationObjectDatos de identificación
identification_typeStringTipo de identificación
identification_numberStringNúmero de identificación
phoneObjectTeléfono
area_codeIntegerCódigo de área
numberIntegerNúmero de teléfono
addressObjectDatos de dirección
zip_codeStringCódigo postal
street_nameStringNombre de calle
street_numberIntegerNúmero de calle
authentication_typeEnumTipo de autenticación ("Gmail" - "Facebook" - "Web Nativa" - "Otro")
registration_dateDateFecha de registro del comprador en el sitio.
is_prime_userBooleanTrue si lo es, False si no lo es.
is_first_purchase_onlineBooleanTrue si lo es, False si no lo es.
last_purchaseDateFecha de la última compra en el sitio.

Sobre envíos

Object shipmentTipoDescripción
receiver_addressObjectDatos de dirección del comprador.
zip_codeStringCódigo postal
state_nameStringProvincia
city_nameStringCiudad
street_numberIntegerNúmero de calle
express_shipmentBooleanTrue si lo es, False si no lo es.

curl

curl --location --request POST 'https://api.mercadopago.com/checkout/preferences' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data-raw '{
    "auto_return": "approved",
    "back_urls": {
        "failure": "https://www.mercadopago.com/us/home/failure",
        "pending": "https://www.mercadopago.com/us/home/pending",
        "success": "https://www.mercadopago.com/us/home/success"
    },
    "notification_url": "https://webhook.site/xyz",
    "expires": false,
    "external_reference": "order-123",
    "date_of_expiration": "2025-03-12T12:58:41.425-04:00",
    "items": [
        {
            "id": "1234",
            "currency_id": "ARS",
            "title": "Producto",
            "picture_url": "",
            "description": "Descripción de producto",
            "category_id": "others",
            "quantity": 1,
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "632 231 354"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av Caseros",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "DNI",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Berta",
        "surname": "Parra",
        "date_created": "",
        "authentication_type": "Facebook",
        "registration date": "2015-06-02T12:58:41.425-04:00",
        "is_prime_user": false,
        "is_first_purchase_online": false,
        "last_purchase": "2020-01-02T12:58:41.425-04:00"
    },
    "payment_methods": {
        "excluded_payment_methods": [
            {
                "id": ""
            }
        ],
        "default_installments": null,
        "default_payment_method_id": null,
        "excluded_payment_types": [
            {
                "id": ""
            }
        ],
        "installments": null
    },
    "shipments": {
        "mode": "not_specified",
        "receiver_address": {
            "zip_code": "52",
            "street_name": "Av Caseros",
            "city_name": "Parque Patricios",
            "state_name": "CABA",
            "street_number": 1000
        },
        "express_shipment": false,
        "local_pickup": false
    }
}'

Gobierno y servicios públicos

Campos a enviar

Agrega toda la información adicional que quieras.

Sobre los ítems

Array itemsTipoDescripción
idStringCódigo
titleStringNombre
descriptionStringDescripción
category_idStringCategoría
quantityIntegerCantidad
unit_priceFloatPrecio unitario
event_dateDateFecha del evento

Sobre el comprador

Object payerTipoDescripción
first_nameStringNombre
last_nameStringApellido
identificationObjectDatos de identificación
identification_typeStringTipo de identificación
identification_numberStringNúmero de identificación
phoneObjectTeléfono
area_codeIntegerCódigo de área
numberIntegerNúmero de teléfono
addressObjectDatos de dirección
zip_codeStringCódigo postal
street_nameStringNombre de calle
street_numberIntegerNúmero de calle
authentication_typeEnumTipo de autenticación ("Gmail" - "Facebook" - "Web Nativa" - "Otro")
registration_dateDateFecha de registro del comprador en el sitio.
is_prime_userBooleanTrue si lo es, False si no lo es.
is_first_purchase_onlineBooleanTrue si lo es, False si no lo es.
last_purchaseDateFecha de la última compra en el sitio.

Sobre envíos

Object shipmentTipoDescripción
receiver_addressObjectDatos de dirección del comprador.
zip_codeStringCódigo postal
state_nameStringProvincia
city_nameStringCiudad
street_numberIntegerNúmero de calle

curl

curl --location --request POST 'https://api.mercadopago.com/checkout/preferences' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data-raw '{
    "auto_return": "approved",
    "back_urls": {
        "failure": "https://www.mercadopago.com/home/failure",
        "pending": "https://www.mercadopago.com/home/pending",
        "success": "https://www.mercadopago.com/home/success"
    },
    "notification_url": "https://webhook.site/xyz",
    "expires": false,
    "external_reference": "order-123",
    "date_of_expiration": "2025-03-12T12:58:41.425-04:00",
    "items": [
        {
            "id": "1234",
            "currency_id": "ARS",
            "title": "Servicio",
            "picture_url": "",
            "description": "Descripción de servicio",
            "category_id": "services",
            "quantity": 1,
            "unit_price": 150,
            "event_date": "2020-06-02T12:58:41.425-04:00"
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "632 231 354"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av Caseros",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "DNI",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Berta",
        "surname": "Parra",
        "date_created": "",
        "authentication_type": "Facebook",
        "registration date": "2015-06-02T12:58:41.425-04:00",
        "is_prime_user": false,
        "is_first_purchase_online": false,
        "last_purchase": "2020-01-02T12:58:41.425-04:00"
    },
    "payment_methods": {
        "excluded_payment_methods": [
            {
                "id": ""
            }
        ],
        "default_installments": null,
        "default_payment_method_id": null,
        "excluded_payment_types": [
            {
                "id": ""
            }
        ],
        "installments": null
    },
    "shipments": {
        "mode": "not_specified",
        "receiver_address": {
            "zip_code": "52",
            "street_name": "Av Caseros",
            "city_name": "Parque Patricios",
            "state_name": "CABA",
            "street_number": 1000
        }
    }
}'

Turismo

Campos a enviar

Agrega toda la información adicional que quieras.

Sobre los ítems

Array itemsTipoDescripción
idStringCódigo
titleStringNombre
descriptionStringDescripción
category_idStringCategoría
quantityIntegerCantidad
unit_priceFloatPrecio unitario
category_descriptorObjectDescripción de la categoría.
passengerObjectInformación adicional del pasajero.
first_nameStringNombre
last_nameStringApellido
identification_typeStringTipo de identificación
identification_numberStringNúmero de identificación
routeObjectInformación de la ruta
departureStringSalida
destinationStringLlegada
departure_date_timeDateFecha de salida
arrival_date_timeDateFecha de llegada
companyStringCompañía

Sobre el comprador

Object payerTipoDescripción
first_nameStringNombre
last_nameStringApellido
identificationObjectDatos de identificación
identification_typeStringTipo de identificación
identification_numberStringNúmero de identificación
phoneObjectTeléfono
area_codeIntegerCódigo de área
numberIntegerNúmero de teléfono
addressObjectDatos de dirección
zip_codeStringCódigo postal
street_nameStringNombre de calle
street_numberIntegerNúmero de calle
authentication_typeEnumTipo de autenticación ("Gmail" - "Facebook" - "Web Nativa" - "Otro")
registration_dateDateFecha de registro del comprador en el sitio.
is_prime_userBooleanTrue si lo es, False si no lo es.
is_first_purchase_onlineBooleanTrue si lo es, False si no lo es.
last_purchaseDateFecha de la última compra en el sitio.

curl

curl --location --request POST 'https://api.mercadopago.com/checkout/preferences' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data-raw '{
    "auto_return": "approved",
    "back_urls": {
        "failure": "https://www.mercadopago.com/home/failure",
        "pending": "https://www.mercadopago.com/home/pending",
        "success": "https://www.mercadopago.com/home/success"
    },
    "notification_url": "https://webhook.site/xyz",
    "expires": false,
    "external_reference": "order-123",
    "date_of_expiration": "2025-03-12T12:58:41.425-04:00",
    "items": [
        {
            "id": "1234",
            "currency_id": "ARS",
            "title": "Servicio",
            "description": "Descripción de servicio",
            "category_id": "Travels",
            "category_descriptor":{
             "passenger": {
                 "first_name": "Berta",
                  "last_name": "Parra",
                   "type": "DNI",
                   "number": 12345678
              },
              "route": {
            	 "departure": "Parque Patricios",
            	 "destination": "Londres",
            	 "departure_date_time": "2022-03-12T12:58:41.425-04:00",
            	 "arrival_date_time": "2022-03-14T12:58:41.425-04:00",
            	 "company": "Compañía"
            }
},
            "quantity": 1,
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "632 231 354"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av Caseros",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "DNI",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Berta",
        "surname": "Parra",
        "date_created": "",
        "authentication_type": "Facebook",
        "registration date": "2015-06-02T12:58:41.425-04:00",
        "is_prime_user": false,
        "is_first_purchase_online": false,
        "last_purchase": "2020-01-02T12:58:41.425-04:00"
    },
    "payment_methods": {
        "excluded_payment_methods": [
            {
                "id": ""
            }
        ],
        "default_installments": null,
        "default_payment_method_id": null,
        "excluded_payment_types": [
            {
                "id": ""
            }
        ],
        "installments": null
    }
}'

Hotelería

Campos a enviar

Agrega toda la información adicional que quieras.

Sobre los ítems

Array itemsTipoDescripción
idStringCódigo
titleStringNombre
category_idStringCategoría
quantityIntegerCantidad
unit_priceFloatPrecio unitario
event_dateDateFecha del evento
category_descriptorObjectDescripción de la categoría.
passengerObjectInformación adicional del pasajero.
first_nameStringNombre
last_nameStringApellido
identification_typeStringTipo de identificación
identification_numberStringNúmero de identificación

Sobre el comprador

Object payerTipoDescripción
first_nameStringNombre
last_nameStringApellido
identificationObjectDatos de identificación
identification_typeStringTipo de identificación
identification_numberStringNúmero de identificación
phoneObjectTeléfono
area_codeIntegerCódigo de área
numberIntegerNúmero de teléfono
addressObjectDatos de dirección
zip_codeStringCódigo postal
street_nameStringNombre de calle
street_numberIntegerNúmero de calle
authentication_typeEnumTipo de autenticación ("Gmail" - "Facebook" - "Web Nativa" - "Otro")
registration_dateDateFecha de registro del comprador en el sitio.
is_prime_userBooleanTrue si lo es, False si no lo es.
is_first_purchase_onlineBooleanTrue si lo es, False si no lo es.
last_purchaseDateFecha de la última compra en el sitio.

curl

curl --location --request POST 'https://api.mercadopago.com/checkout/preferences' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data-raw '{
    "auto_return": "approved",
    "back_urls": {
        "failure": "https://www.mercadopago.com/home/failure",
        "pending": "https://www.mercadopago.com/home/pending",
        "success": "https://www.mercadopago.com/home/success"
    },
    "notification_url": "https://webhook.site/xyz",
    "expires": false,
    "external_reference": "order-123",
    "date_of_expiration": "2025-03-12T12:58:41.425-04:00",
    "items": [
        {
            "id": "1234",
            "currency_id": "ARS",
            "title": "Servicio",
            "description": "Descripción de servicio",
            "category_id": "Travels",
            "category_descriptor": {
                "passenger": {
                    "first_name": "Berta",
                    "last_name": "Parra",
                    "type": "DNI",
                    "number": 12345678
                }
            },
            "quantity": 1,
            "event_date": "2020-06-02T12:58:41.425-04:00",
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "632 231 354"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av Caseros",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "DNI",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Berta",
        "surname": "Parra",
        "date_created": "",
        "authentication_type": "Facebook",
        "registration date": "2015-06-02T12:58:41.425-04:00",
        "is_prime_user": false,
        "is_first_purchase_online": false,
        "last_purchase": "2020-01-02T12:58:41.425-04:00"
    },
    "payment_methods": {
        "excluded_payment_methods": [
            {
                "id": ""
            }
        ],
        "default_installments": null,
        "default_payment_method_id": null,
        "excluded_payment_types": [
            {
                "id": ""
            }
        ],
        "installments": null
    }
}'

Utilities

Campos a enviar

Agrega toda la información adicional que quieras.

Sobre los ítems

Array itemsTipoDescripción
idStringCódigo
titleStringNombre
category_idStringCategoría
quantityIntegerCantidad
unit_priceFloatPrecio unitario

Sobre el comprador

Object payerTipoDescripción
first_nameStringNombre
last_nameStringApellido
identificationObjectDatos de identificación
identification_typeStringTipo de identificación
identification_numberStringNúmero de identificación
phoneObjectTeléfono
area_codeIntegerCódigo de área
numberIntegerNúmero de teléfono
addressObjectDatos de dirección
zip_codeStringCódigo postal
street_nameStringNombre de calle
street_numberIntegerNúmero de calle
authentication_typeEnumTipo de autenticación ("Gmail" - "Facebook" - "Web Nativa" - "Otro")
registration_dateDateFecha de registro del comprador en el sitio.
is_prime_userBooleanTrue si lo es, False si no lo es.
is_first_purchase_onlineBooleanTrue si lo es, False si no lo es.
last_purchaseDateFecha de la última compra en el sitio.

curl

curl --location --request POST 'https://api.mercadopago.com/checkout/preferences' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data-raw '{
    "auto_return": "approved",
    "back_urls": {
        "failure": "https://www.mercadopago.com/home/failure",
        "pending": "https://www.mercadopago.com/home/pending",
        "success": "https://www.mercadopago.com/home/success"
    },
    "notification_url": "https://webhook.site/xyz",
    "expires": false,
    "external_reference": "order-123",
    "date_of_expiration": "2025-03-12T12:58:41.425-04:00",
    "items": [
        {
            "id": "1234",
            "currency_id": "ARS",
            "title": "Producto",
            "picture_url": "",
            "category_id": "others",
            "quantity": 1,
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "632 231 354"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av Caseros",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "DNI",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Berta",
        "surname": "Parra",
        "date_created": "",
        "authentication_type": "Facebook",
        "registration date": "2015-06-02T12:58:41.425-04:00",
        "is_prime_user": false,
        "is_first_purchase_online": false,
        "last_purchase": "2020-01-02T12:58:41.425-04:00"
    },
    "payment_methods": {
        "excluded_payment_methods": [
            {
                "id": ""
            }
        ],
        "default_installments": null,
        "default_payment_method_id": null,
        "excluded_payment_types": [
            {
                "id": ""
            }
        ],
        "installments": null
    }
}'

Venta directa

Campos a enviar

Agrega toda la información adicional que quieras.

Sobre los ítems

Array itemsTipoDescripción
idStringCódigo
titleStringNombre
descriptionStringDescripción
category_idStringCategoría
quantityIntegerCantidad
unit_priceFloatPrecio unitario

Sobre el comprador

Object payerTipoDescripción
first_nameStringNombre
last_nameStringApellido
identificationObjectDatos de identificación
identification_typeStringTipo de identificación
identification_numberStringNúmero de identificación
phoneObjectTeléfono
area_codeIntegerCódigo de área
numberIntegerNúmero de teléfono
addressObjectDatos de dirección
zip_codeStringCódigo postal
street_nameStringNombre de calle
street_numberIntegerNúmero de calle
authentication_typeEnumTipo de autenticación ("Gmail" - "Facebook" - "Web Nativa" - "Otro")
registration_dateDateFecha de registro del comprador en el sitio.
is_prime_userBooleanTrue si lo es, False si no lo es.
is_first_purchase_onlineBooleanTrue si lo es, False si no lo es.
last_purchaseDateFecha de la última compra en el sitio.

Sobre envíos

Object shipmentTipoDescripción
receiver_addressObjectDatos de dirección del comprador.
zip_codeStringCódigo postal
state_nameStringProvincia
city_nameStringCiudad
street_numberIntegerNúmero de calle
floorStringPiso
apartmentStringApartamento
local_pickupBooleanTrue si se retira en sucursal, False si no lo hace.

curl

curl --location --request POST 'https://api.mercadopago.com/checkout/preferences' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data-raw '{
    "auto_return": "approved",
    "back_urls": {
        "failure": "https://www.mercadopago.com/home/failure",
        "pending": "https://www.mercadopago.com/home/pending",
        "success": "https://www.mercadopago.com/home/success"
    },
    "notification_url": "https://webhook.site/xyz",
    "expires": false,
    "external_reference": "order-123",
    "date_of_expiration": "2025-03-12T12:58:41.425-04:00",
    "items": [
        {
            "id": "1234",
            "currency_id": "ARS",
            "title": "Producto",
            "picture_url": "",
            "description": "Descripción de producto",
            "category_id": "others",
            "quantity": 1,
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "632 231 354"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av Caseros",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "DNI",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Berta",
        "surname": "Parra",
        "date_created": "",
        "authentication_type": "Facebook",
        "registration date": "2015-06-02T12:58:41.425-04:00",
        "is_prime_user": false,
        "is_first_purchase_online": false,
        "last_purchase": "2020-01-02T12:58:41.425-04:00"
    },
    "payment_methods": {
        "excluded_payment_methods": [
            {
                "id": ""
            }
        ],
        "default_installments": null,
        "default_payment_method_id": null,
        "excluded_payment_types": [
            {
                "id": ""
            }
        ],
        "installments": null
    },
    "shipments": {
        "mode": "not_specified",
        "local_pickup": false,
        "receiver_address": {
            "zip_code": "52",
            "street_name": "Av Caseros",
            "city_name": "Parque Patricios",
            "state_name": "CABA",
            "street_number": 1000
            "floor": "12",
            "apartment": "B"
        }
    }
}'

Automóviles y náuticas

Campos a enviar

Agrega toda la información adicional que quieras.

Sobre los ítems

Array itemsTipoDescripción
idStringCódigo
titleStringNombre
descriptionStringDescripción
category_idStringCategoría
quantityIntegerCantidad
unit_priceFloatPrecio unitario

Sobre el comprador

Object payerTipoDescripción
first_nameStringNombre
last_nameStringApellido
identificationObjectDatos de identificación
identification_typeStringTipo de identificación
identification_numberStringNúmero de identificación
phoneObjectTeléfono
area_codeIntegerCódigo de área
numberIntegerNúmero de teléfono
addressObjectDatos de dirección
zip_codeStringCódigo postal
street_nameStringNombre de calle
street_numberIntegerNúmero de calle
authentication_typeEnumTipo de autenticación ("Gmail" - "Facebook" - "Web Nativa" - "Otro")
registration_dateDateFecha de registro del comprador en el sitio.
is_first_purchase_onlineBooleanTrue si lo es, False si no lo es.
last_purchaseDateFecha de la última compra en el sitio.

Sobre envíos

Object shipmentTipoDescripción
receiver_addressObjectDatos de dirección del comprador.
zip_codeStringCódigo postal
state_nameStringProvincia
city_nameStringCiudad
street_numberIntegerNúmero de calle
floorStringPiso
apartmentStringApartamento
local_pickupBooleanTrue si se retira en sucursal, False si no lo hace.

curl

curl --location --request POST 'https://api.mercadopago.com/checkout/preferences' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data-raw '{
    "auto_return": "approved",
    "back_urls": {
        "failure": "https://www.mercadopago.com/home/failure",
        "pending": "https://www.mercadopago.com/home/pending",
        "success": "https://www.mercadopago.com/home/success"
    },
    "notification_url": "https://webhook.site/xyz",
    "expires": false,
    "external_reference": "order-123",
    "date_of_expiration": "2025-03-12T12:58:41.425-04:00",
    "items": [
        {
            "id": "1234",
            "currency_id": "ARS",
            "title": "Producto",
            "picture_url": "",
            "description": "Descripción de producto",
            "category_id": "others",
            "quantity": 1,
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "632 231 354"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av Caseros",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "DNI",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Berta",
        "surname": "Parra",
        "date_created": "",
        "authentication_type": "Facebook",
        "registration date": "2015-06-02T12:58:41.425-04:00",
        "is_first_purchase_online": false,
        "last_purchase": "2020-01-02T12:58:41.425-04:00"
    },
    "payment_methods": {
        "excluded_payment_methods": [
            {
                "id": ""
            }
        ],
        "default_installments": null,
        "default_payment_method_id": null,
        "excluded_payment_types": [
            {
                "id": ""
            }
        ],
        "installments": null
    },
    "shipments": {
        "mode": "not_specified",
        "local_pickup": false,
        "receiver_address": {
            "zip_code": "52",
            "street_name": "Av Caseros",
            "city_name": "Parque Patricios",
            "state_name": "CABA",
            "street_number": 1000
            "floor": "12",
            "apartment": "B"
        }
    }
}'

Transporte urbano

Campos a enviar

Agrega toda la información adicional que quieras.

Sobre los ítems

Array itemsTipoDescripción
idStringCódigo
titleStringNombre
descriptionStringDescripción
category_idStringCategoría
quantityIntegerCantidad
unit_priceFloatPrecio unitario

Sobre el comprador

Object payerTipoDescripción
first_nameStringNombre
last_nameStringApellido
identificationObjectDatos de identificación
identification_typeStringTipo de identificación
identification_numberStringNúmero de identificación
phoneObjectTeléfono
area_codeIntegerCódigo de área
numberIntegerNúmero de teléfono
addressObjectDatos de dirección
zip_codeStringCódigo postal
street_nameStringNombre de calle
street_numberIntegerNúmero de calle
authentication_typeEnumTipo de autenticación ("Gmail" - "Facebook" - "Web Nativa" - "Otro")
registration_dateDateFecha de registro del comprador en el sitio.
is_prime_userBooleanTrue si lo es, False si no lo es.
is_first_purchase_onlineBooleanTrue si lo es, False si no lo es.
last_purchaseDateFecha de la última compra en el sitio.

curl

curl --location --request POST 'https://api.mercadopago.com/checkout/preferences' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data-raw '{
    "auto_return": "approved",
    "back_urls": {
        "failure": "https://www.mercadopago.com/home/failure",
        "pending": "https://www.mercadopago.com/home/pending",
        "success": "https://www.mercadopago.com/home/success"
    },
    "notification_url": "https://webhook.site/xyz",
    "expires": false,
    "external_reference": "order-123",
    "date_of_expiration": "2025-03-12T12:58:41.425-04:00",
    "items": [
        {
            "id": "1234",
            "currency_id": "ARS",
            "title": "Producto",
            "picture_url": "",
            "description": "Descripción de producto",
            "category_id": "others",
            "quantity": 1,
            "unit_price": 150
        }
    ],
    "payer": {
        "phone": {
            "area_code": "11",
            "number": "632 231 354"
        },
        "address": {
            "zip_code": "52",
            "street_name": "Av Caseros",
            "street_number": 1000
        },
        "identification": {
          "identification_type": "DNI",
          "identification_number": "12345678"
        },
        "email": "john@yourdomain.com",
        "name": "Berta",
        "surname": "Parra",
        "date_created": "",
        "authentication_type": "Facebook",
        "registration date": "2015-06-02T12:58:41.425-04:00",
        "is_first_purchase_online": false,
        "is_prime_user": false,
        "last_purchase": "2020-01-02T12:58:41.425-04:00"
    },
    "payment_methods": {
        "excluded_payment_methods": [
            {
                "id": ""
            }
        ],
        "default_installments": null,
        "default_payment_method_id": null,
        "excluded_payment_types": [
            {
                "id": ""
            }
        ],
        "installments": null
    }
}'
¿Te resultó útil esta información?

Mercado Pago ofrece servicios de pago y no está autorizado por el Banco Central a operar como entidad financiera. Los fondos acreditados en cuentas de pago no constituyen depósitos en una entidad financiera ni están garantizados conforme legislación aplicable a depósitos en entidades financieras. Copyright © 2021 MercadoLibre S.R.L.

Términos y condicionesCómo cuidamos tu privacidad
Partners Mercado Pago

Al navegar en este sitio aceptás las cookies que utilizamos para mejorar tu experiencia. Más información.