# MD for: https://www.mercadopago.com.uy/developers/en/docs/checkout-pro/how-tos/improve-payment-approval/industry-data.md

\# Industry data According to your business sector or industry, you can include additional information when creating the payment that helps increase approval chances. Below, you will find specific data for these industries that you can add to your integration. :::AccordionComponent{title="Apparel"} Add any additional information you consider necessary about: - Items (\_array\_ \`items\`) | Array \`items\` | Type | Description | | --- | --- | --- | | \`id\` | \_String\_ | Code | | \`title\` | \_String\_ | Name | | \`type\` | \_String\_ | Type | | \`description\` | \_String\_ | Description | | \`picture\_url\` | \_String\_ | Picture URL | | \`category\_id\` | \_String\_ | Category | | \`quantity\` | \_Integer\_ | Quantity | | \`unit\_price\` | \_Float\_ | Unit price | - Buyer (\_object\_ \`payer\`) | Object \`payer\` | Type | Description | | --- | --- | --- | | \`first\_name\` | \_String\_ | Name | | \`last\_name\` | \_String\_ | Surname | | \`identification\` | \_Object\_ | Identification data | | \`identification\_type\` | \_String\_ | Identification type | | \`identification\_number\` | \_String\_ | Identification number | | \`phone\` | \_Object\_ | Phone | | \`area\_code\` | \_Integer\_ | Area Code | | \`number\` | \_Integer\_ | Phone number | | \`address\` | \_Object\_ | Adress data | | \`zip\_code\` | \_String\_ | Postal code | | \`street\_name\` | \_String\_ | Street name | | \`street\_number\` | \_Integer\_ | Street number | | \`authentication\_type\` | \_Enum\_ | Authentication type ("Gmail" - "Facebook" - "Native web" - "Other") | | \`date\_created\` | \_Date\_ | Buyer's registration date on the site. | | \`is\_prime\_user\` | \_Boolean\_ | \`True\` if it is, \`False\` if it is not. | | \`is\_first\_purchase\_online\` | \_Boolean\_ | \`True\` if it is, \`False\` if it is not. | | \`last\_purchase\` | \_Date\_ | Date of the last purchase on the site. | - Shipments (\_object\_ \`shipment\`) | Object \`shipment\` | Type | Description | | --- | --- | --- | | \`receiver\_address\` | \_Object\_ | Address of the buyer. | | \`zip\_code\` | \_String\_ | Postal code | | \`state\_name\` | \_String\_ | Province | | \`city\_name\` | \_String\_ | City | | \`street\_number\` | \_Integer\_ | Street number | | \`express\_shipment\` | \_Boolean\_ | \`True\` if it is, \`False\` if it is not. | Below, you will find an example of how to send the data presented in the tables above: \`\`\`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": "UYU", "title": "Product", "picture\_url": "", "description": "Product Description", "type": "test", "category\_id": "fashion", "quantity": 1, "unit\_price": 150 } \], "payer": { "phone": { "area\_code": "11", "number": "656971212" }, "address": { "zip\_code": "52", "street\_name": "Av Libertador Lavalleja", "street\_number": 1000 }, "identification": { "identification\_type": "CI", "identification\_number": "12345678" }, "email": "john@yourdomain.com", "first\_name": "María Eugenia", "last\_name": "Valentín", "date\_created": "", "authentication\_type": "Facebook", "date\_created": "2015-06-02T12:58:41.425-04:00", "is\_prime\_user": false, "is\_first\_purchase\_online": false, "last\_purchase": "2020-01-02T12:58:41.425-04:00" }, "payment\_methods": { "excluded\_payment\_methods": \[ { "id": "" } \], "default\_installments": null, "default\_payment\_method\_id": null, "excluded\_payment\_types": \[ { "id": "" } \], "installments": null }, "shipments": { "mode": "not\_specified", "receiver\_address": { "zip\_code": "52", "street\_name": "Av Libertador Lavalleja", "city\_name": "Montevideo", "state\_name": "Montevideo", "street\_number": 1000 }, "express\_shipment": false } }' \`\`\` ::: :::AccordionComponent{title="Electro"} Add any additional information you consider necessary about: - Items (\_array\_ \`items\`) | Array \`items\` | Type | Description | | --- | --- | --- | | \`id\` | \_String\_ | Code | | \`title\` | \_String\_ | Name | | \`category\_id\` | \_String\_ | Category | | \`quantity\` | \_Integer\_ | Quantity | | \`unit\_price\` | \_Float\_ | Unit price | | \`warranty\` | \_Boolean\_ | \`True\` if the product has a guarantee, \`False\` if it does not. | - Buyer (\_object\_ \`payer\`) | Object \`payer\` | Type | Description | | --- | --- | --- | | \`first\_name\` | \_String\_ | Name | | \`last\_name\` | \_String\_ | Surname | | \`identification\` | \_Object\_ | Identification data | | \`identification\_type\` | \_String\_ | Identification type | | \`identification\_number\` | \_String\_ | Identification number | | \`phone\` | \_Object\_ | Phone | | \`area\_code\` | \_Integer\_ | Area Code | | \`number\` | \_Integer\_ | Phone number | | \`address\` | \_Object\_ | Adress data | | \`zip\_code\` | \_String\_ | Postal code | | \`street\_name\` | \_String\_ | Street name | | \`street\_number\` | \_Integer\_ | Street number | | \`authentication\_type\` | \_Enum\_ | Authentication type ("Gmail" - "Facebook" - "Native web" - "Other") | | \`date\_created\` | \_Date\_ | Buyer's registration date on the site. | | \`is\_prime\_user\` | \_Boolean\_ | \`True\` if it is, \`False\` if it is not. | | \`is\_first\_purchase\_online\` | \_Boolean\_ | \`True\` if it is, \`False\` if it is not. | | \`last\_purchase\` | \_Date\_ | Date of the last purchase on the site. | - Shipments (\_object\_ \`shipment\`) | Object \`shipment\` | Type | Description | | --- | --- | --- | | \`local\_pickup\` | \_Boolean\_ | \`True\` if you withdraw in branch, \`False\` if you do not. | | \`receiver\_address\` | \_Object\_ | Address of the buyer. | | \`zip\_code\` | \_String\_ | Postal code | | \`state\_name\` | \_String\_ | Province | | \`city\_name\` | \_String\_ | City | | \`street\_number\` | \_Integer\_ | Street number | | \`express\_shipment\` | \_Boolean\_ | \`True\` if it is, \`False\` if it is not. | Below, you will find an example of how to send the data presented in the tables above: \`\`\`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": "UYU", "title": "Product", "category\_id": "phones", "quantity": 1, "unit\_price": 150, "warranty": false, } \], "payer": { "phone": { "area\_code": "11", "number": "656971212" }, "address": { "zip\_code": "52", "street\_name": "Av Libertador Lavalleja", "street\_number": 1000 }, "identification": { "identification\_type": "CI", "identification\_number": "12345678" }, "email": "john@yourdomain.com”, "first\_name": "María Eugenia", "last\_name": "Valentín", "date\_created": "", "authentication\_type": "Facebook", "date\_created": "2015-06-02T12:58:41.425-04:00", "is\_prime\_user": false, "is\_first\_purchase\_online": false, "last\_purchase": "2020-01-02T12:58:41.425-04:00" }, "payment\_methods": { "excluded\_payment\_methods": \[ { "id": "" } \], "default\_installments": null, "default\_payment\_method\_id": null, "excluded\_payment\_types": \[ { "id": "" } \], "installments": null }, "shipments": { "mode": "not\_specified", "receiver\_address": { "zip\_code": "52", "street\_name": "Av Libertador Lavalleja", "city\_name": "Montevideo", "state\_name": "Montevideo", "street\_number": 1000 }, "express\_shipment": false, "local\_pickup": false } }' \`\`\` ::: :::AccordionComponent{title="Tickets and entertainment"} Add any additional information you consider necessary about: - Items (\_array\_ \`items\`) | Array \`items\` | Type | Description | | --- | --- | --- | | \`id\` | \_String\_ | Code | | \`title\` | \_String\_ | Name | | \`category\_id\` | \_String\_ | Category | | \`quantity\` | \_Integer\_ | Quantity | | \`unit\_price\` | \_Float\_ | Unit price | | \`category\_descriptor\` | \_Object\_ | Category description | | \`event\_date\` | \_Date\_ | Event date. Must be sent within the \`category\_descriptor\` object. Must be sent in ISO 8601 format (date and time, in UTC). | - Buyer (\_object\_ \`payer\`) | Object \`payer\` | Type | Description | | --- | --- | --- | | \`first\_name\` | \_String\_ | Name | | \`last\_name\` | \_String\_ | Surname | | \`identification\` | \_Object\_ | Identification data | | \`identification\_type\` | \_String\_ | Identification type | | \`identification\_number\` | \_String\_ | Identification number | | \`phone\` | \_Object\_ | Phone | | \`area\_code\` | \_Integer\_ | Area Code | | \`number\` | \_Integer\_ | Phone number | | \`authentication\_type\` | \_Enum\_ | Authentication type ("Gmail" - "Facebook" - "Native web" - "Other") | | \`date\_created\` | \_Date\_ | Buyer's registration date on the site. | | \`is\_prime\_user\` | \_Boolean\_ | \`True\` if it is, \`False\` if it is not. | | \`is\_first\_purchase\_online\` | \_Boolean\_ | \`True\` if it is, \`False\` if it is not. | | \`last\_purchase\` | \_Date\_ | Date of the last purchase on the site. | - Shipments (\_object\_ \`shipment\`) | Object \`shipment\` | Type | Description | | --- | --- | --- | | \`receiver\_address\` | \_Object\_ | Address of the buyer. | | \`zip\_code\` | \_String\_ | Postal code | | \`state\_name\` | \_String\_ | Province | | \`city\_name\` | \_String\_ | City | | \`street\_number\` | \_Integer\_ | Street number | | \`express\_shipment\` | \_Boolean\_ | \`True\` if it is, \`False\` if it is not. | Below, you will find an example of how to send the data presented in the tables above: \`\`\`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": "UYU", "title": "Product", "category\_id": "entertainment", "quantity": 1, "unit\_price": 150, "category\_descriptor":{ "event\_date": "2022-03-12T12:58:41.425-04:00" }, } \], "payer": { "phone": { "area\_code": "11", "number": "656971212" }, "identification": { "identification\_type": "CI", "identification\_number": "12345678" }, "email": "john@yourdomain.com", "first\_name": "María Eugenia", "last\_name": "Valentín", "date\_created": "", "authentication\_type": "Facebook", "date\_created": "2015-06-02T12:58:41.425-04:00", "is\_prime\_user": false, "is\_first\_purchase\_online": false, "last\_purchase": "2020-01-02T12:58:41.425-04:00" }, "payment\_methods": { "excluded\_payment\_methods": \[ { "id": "" } \], "default\_installments": null, "default\_payment\_method\_id": null, "excluded\_payment\_types": \[ { "id": "" } \], "installments": null }, "shipments": { "mode": "not\_specified", "receiver\_address": { "zip\_code": "52", "street\_name": "Av Libertador Lavalleja", "city\_name": "Montevideo", "state\_name": "Montevideo", "street\_number": 1000 }, "express\_shipment": false, "local\_pickup": false } }' \`\`\` ::: :::AccordionComponent{title="Home and decoration"} Add any additional information you consider necessary about: - Items (\_array\_ \`items\`) | Array \`items\` | Type | Description | | --- | --- | --- | | \`id\` | \_String\_ | Code | | \`title\` | \_String\_ | Name | | \`description\` | \_String\_ | Description | | \`category\_id\` | \_String\_ | Category | | \`quantity\` | \_Integer\_ | Quantity | | \`unit\_price\` | \_Float\_ | Unit price | | \`warranty\` | \_Boolean\_ | \`True\` if the product has a guarantee, \`False\` if it does not. | - Buyer (\_object\_ \`payer\`) | Object \`payer\` | Type | Description | | --- | --- | --- | | \`first\_name\` | \_String\_ | Name | | \`last\_name\` | \_String\_ | Surname | | \`identification\` | \_Object\_ | Identification data | | \`identification\_type\` | \_String\_ | Identification type | | \`identification\_number\` | \_String\_ | Identification number | | \`phone\` | \_Object\_ | Phone | | \`area\_code\` | \_Integer\_ | Area code | | \`number\` | \_Integer\_ | Phone number | | \`address\` | \_Object\_ | Adress data | | \`zip\_code\` | \_String\_ | Postal code | | \`street\_name\` | \_String\_ | Street name | | \`street\_number\` | \_Integer\_ | Street number | | \`authentication\_type\` | \_Enum\_ | Authentication type ("Gmail" - "Facebook" - "Native web" - "Other") | | \`date\_created\` | \_Date\_ | Buyer's registration date on the site. | | \`is\_prime\_user\` | \_Boolean\_ | \`True\` if it is, \`False\` if it is not. | | \`is\_first\_purchase\_online\` | \_Boolean\_ | \`True\` if it is, \`False\` if it is not. | | \`last\_purchase\` | \_Date\_ | Date of the last purchase on the site. | - Shipments (\_object\_ \`shipment\`) | Object \`shipment\` | Type | Description | | --- | --- | --- | | \`receiver\_address\` | \_Object\_ | Address of the buyer. | | \`zip\_code\` | \_String\_ | Postal code | | \`state\_name\` | \_String\_ | Province | | \`city\_name\` | \_String\_ | City | | \`street\_number\` | \_Integer\_ | Street number | | \`express\_shipment\` | \_Boolean\_ | \`True\` if it is, \`False\` if it is not. | Below, you will find an example of how to send the data presented in the tables above: \`\`\`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": "UYU", "title": "Product", "picture\_url": "", "description": "Product Description", "category\_id": "home", "quantity": 1, "unit\_price": 150, "warranty": false, } \], "payer": { "phone": { "area\_code": "11", "number": "656971212" }, "address": { "zip\_code": "52", "street\_name": "Av Libertador Lavalleja", "street\_number": 1000 }, "identification": { "identification\_type": "CI", "identification\_number": "12345678" }, "email": "john@yourdomain.com", "first\_name": "María Eugenia", "last\_name": "Valentín", "date\_created": "", "authentication\_type": "Facebook", "date\_created": "2015-06-02T12:58:41.425-04:00", "is\_prime\_user": false, "is\_first\_purchase\_online": false, "last\_purchase": "2020-01-02T12:58:41.425-04:00" }, "payment\_methods": { "excluded\_payment\_methods": \[ { "id": "" } \], "default\_installments": null, "default\_payment\_method\_id": null, "excluded\_payment\_types": \[ { "id": "" } \], "installments": null }, "shipments": { "mode": "not\_specified", "receiver\_address": { "zip\_code": "52", "street\_name": "Av Libertador Lavalleja", "city\_name": "Montevideo", "state\_name": "Montevideo", "street\_number": 1000 }, "express\_shipment": false, "local\_pickup": false } }' \`\`\` ::: :::AccordionComponent{title="Applications and online platforms"} Add any additional information you consider necessary about: - Items (\_array\_ \`items\`) | Array \`items\` | Type | Description | | --- | --- | --- | | \`id\` | \_String\_ | Code | | \`title\` | \_String\_ | Name | | \`category\_id\` | \_String\_ | Category | | \`quantity\` | \_Integer\_ | Quantity | | \`unit\_price\` | \_Float\_ | Unit price | - Buyer (\_object\_ \`payer\`) | Object \`payer\` | Type | Description | | --- | --- | --- | | \`first\_name\` | \_String\_ | Name | | \`last\_name\` | \_String\_ | Surname | | \`identification\` | \_Object\_ | Identification data | | \`identification\_type\` | \_String\_ | Identification type | | \`identification\_number\` | \_String\_ | Identification number | | \`phone\` | \_Object\_ | Phone | | \`area\_code\` | \_Integer\_ | Area code | | \`number\` | \_Integer\_ | Phone number | | \`address\` | \_Object\_ | Adress data | | \`zip\_code\` | \_String\_ | Postal code | | \`street\_name\` | \_String\_ | Street name | | \`street\_number\` | \_Integer\_ | Street number | | \`authentication\_type\` | \_Enum\_ | Authentication type ("Gmail" - "Facebook" - "Native web" - "Other") | | \`date\_created\` | \_Date\_ | Buyer's registration date on the site. | | \`is\_prime\_user\` | \_Boolean\_ | \`True\` if it is, \`False\` if it is not. | | \`is\_first\_purchase\_online\` | \_Boolean\_ | \`True\` if it is, \`False\` if it is not. | | \`last\_purchase\` | \_Date\_ | Date of the last purchase on the site. | Below, you will find an example of how to send the data presented in the tables above: \`\`\`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": "UYU", "title": "Product", "picture\_url": "", "description": "Product Description", "category\_id": "services", "quantity": 1, "unit\_price": 150 } \], "payer": { "phone": { "area\_code": "11", "number": "656971212" }, "address": { "zip\_code": "52", "street\_name": "Av Libertador Lavalleja", "street\_number": 1000 }, "identification": { "identification\_type": "CI", "identification\_number": "12345678" }, "email": "john@yourdomain.com", "name": "María Eugenia", "surname": "Valentín", "date\_created": "", "authentication\_type": "Facebook", "date\_created": "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 } }' \`\`\` ::: :::AccordionComponent{title="Retail"} Add any additional information you consider necessary about: - Items (\_array\_ \`items\`) | Array \`items\` | Type | Description | | --- | --- | --- | | \`id\` | \_String\_ | Code | | \`title\` | \_String\_ | Name | | \`description\` | \_String\_ | Description | | \`picture\_url\` | \_String\_ | Picture URL | | \`category\_id\` | \_String\_ | Category | | \`quantity\` | \_Integer\_ | Quantity | | \`unit\_price\` | \_Float\_ | Unit price | - Buyer (\_object\_ \`payer\`) | Object \`payer\` | Type | Description | | --- | --- | --- | | \`first\_name\` | \_String\_ | Name | | \`last\_name\` | \_String\_ | Surname | | \`identification\` | \_Object\_ | Identification data | | \`identification\_type\` | \_String\_ | Identification type | | \`identification\_number\` | \_String\_ | Identification number | | \`phone\` | \_Object\_ | Phone | | \`area\_code\` | \_Integer\_ | Area code | | \`number\` | \_Integer\_ | Phone number | | \`address\` | \_Object\_ | Adress data | | \`zip\_code\` | \_String\_ | Postal code | | \`street\_name\` | \_String\_ | Street name | | \`street\_number\` | \_Integer\_ | Street number | | \`authentication\_type\` | \_Enum\_ | Authentication type ("Gmail" - "Facebook" - "Native web" - "Other") | | \`date\_created\` | \_Date\_ | Buyer's registration date on the site. | | \`is\_prime\_user\` | \_Boolean\_ | \`True\` if it is, \`False\` if it is not. | | \`is\_first\_purchase\_online\` | \_Boolean\_ | \`True\` if it is, \`False\` if it is not. | | \`last\_purchase\` | \_Date\_ | Date of the last purchase on the site. | - Shipments (\_object\_ \`shipment\`) | Object \`shipment\` | Type | Description | | --- | --- | --- | | \`receiver\_address\` | \_Object\_ | Address of the buyer. | | \`zip\_code\` | \_String\_ | Postal code | | \`state\_name\` | \_String\_ | Province | | \`city\_name\` | \_String\_ | City | | \`street\_number\` | \_Integer\_ | Street number | | \`express\_shipment\` | \_Boolean\_ | \`True\` if it is, \`False\` if it is not. | Below, you will find an example of how to send the data presented in the tables above: \`\`\`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": "UYU", "title": "Product", "picture\_url": "", "description": "Product Description", "category\_id": "others", "quantity": 1, "unit\_price": 150 } \], "payer": { "phone": { "area\_code": "11", "number": "656971212" }, "address": { "zip\_code": "52", "street\_name": "Av Libertador Lavalleja", "street\_number": 1000 }, "identification": { "identification\_type": "CI", "identification\_number": "12345678" }, "email": "john@yourdomain.com", "name": "María Eugenia", "surname": "Valentín", "date\_created": "", "authentication\_type": "Facebook", "date\_created": "2015-06-02T12:58:41.425-04:00", "is\_prime\_user": false, "is\_first\_purchase\_online": false, "last\_purchase": "2020-01-02T12:58:41.425-04:00" }, "payment\_methods": { "excluded\_payment\_methods": \[ { "id": "" } \], "default\_installments": null, "default\_payment\_method\_id": null, "excluded\_payment\_types": \[ { "id": "" } \], "installments": null }, "shipments": { "mode": "not\_specified", "receiver\_address": { "zip\_code": "52", "street\_name": "Av Libertador Lavalleja", "city\_name": "Montevideo", "state\_name": "Montevideo", "street\_number": 1000 }, "express\_shipment": false, "local\_pickup": false } }' \`\`\` ::: :::AccordionComponent{title="Government and public services"} Add any additional information you consider necessary about: - Items (\_array\_ \`items\`) | Array \`items\` | Type | Description | | --- | --- | --- | | \`id\` | \_String\_ | Code | | \`title\` | \_String\_ | Name | | \`description\` | \_String\_ | Description | | \`category\_id\` | \_String\_ | Category | | \`quantity\` | \_Integer\_ | Quantity | | \`unit\_price\` | \_Float\_ | Unit price | | \`category\_descriptor\` | \_Object\_ | Category description | | \`event\_date\` | \_Date\_ | Event date | - Buyer (\_object\_ \`payer\`) | Object \`payer\` | Type | Description | | --- | --- | --- | | \`first\_name\` | \_String\_ | Name | | \`last\_name\` | \_String\_ | Surname | | \`identification\` | \_Object\_ | Identification data | | \`identification\_type\` | \_String\_ | Identification type | | \`identification\_number\` | \_String\_ | Identification number | | \`phone\` | \_Object\_ | Phone | | \`area\_code\` | \_Integer\_ | Area code | | \`number\` | \_Integer\_ | Phone number | | \`address\` | \_Object\_ | Adress data | | \`zip\_code\` | \_String\_ | Postal code | | \`street\_name\` | \_String\_ | Street name | | \`street\_number\` | \_Integer\_ | Street number | | \`authentication\_type\` | \_Enum\_ | Authentication type ("Gmail" - "Facebook" - "Native web" - "Other") | | \`date\_created\` | \_Date\_ | Buyer's registration date on the site. | | \`is\_prime\_user\` | \_Boolean\_ | \`True\` if it is, \`False\` if it is not. | | \`is\_first\_purchase\_online\` | \_Boolean\_ | \`True\` if it is, \`False\` if it is not. | | \`last\_purchase\` | \_Date\_ | Date of the last purchase on the site. | - Shipments (\_object\_ \`shipment\`) | Object \`shipment\` | Type | Description | | --- | --- | --- | | \`receiver\_address\` | \_Object\_ | Address of the buyer. | | \`zip\_code\` | \_String\_ | Postal code | | \`state\_name\` | \_String\_ | Province | | \`city\_name\` | \_String\_ | City | | \`street\_number\` | \_Integer\_ | Street number | Below, you will find an example of how to send the data presented in the tables above: \`\`\`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": "UYU", "title": "Service", "picture\_url": "", "description": "Service description", "category\_id": "services", "quantity": 1, "unit\_price": 150, "category\_descriptor":{ "event\_date": "2022-03-12T12:58:41.425-04:00" }, } \], "payer": { "phone": { "area\_code": "11", "number": "656971212" }, "address": { "zip\_code": "52", "street\_name": "Av Libertador Lavalleja", "street\_number": 1000 }, "identification": { "identification\_type": "CI", "identification\_number": "12345678" }, "email": "john@yourdomain.com", "name": "María Eugenia", "surname": "Valentín", "date\_created": "", "authentication\_type": "Facebook", "date\_created": "2015-06-02T12:58:41.425-04:00", "is\_prime\_user": false, "is\_first\_purchase\_online": false, "last\_purchase": "2020-01-02T12:58:41.425-04:00" }, "payment\_methods": { "excluded\_payment\_methods": \[ { "id": "" } \], "default\_installments": null, "default\_payment\_method\_id": null, "excluded\_payment\_types": \[ { "id": "" } \], "installments": null }, "shipments": { "mode": "not\_specified", "receiver\_address": { "zip\_code": "52", "street\_name": "Av Libertador Lavalleja", "city\_name": "Montevideo", "state\_name": "Montevideo", "street\_number": 1000 } } }' \`\`\` ::: :::AccordionComponent{title="Tourism"} Add any additional information you consider necessary about: - Items (\_array\_ \`items\`) | Array \`items\` | Type | Description | | --- | --- | --- | | \`id\` | \_String\_ | Code | | \`title\` | \_String\_ | Name | | \`description\` | \_String\_ | Description | | \`category\_id\` | \_String\_ | Category | | \`quantity\` | \_Integer\_ | Quantity | | \`unit\_price\` | \_Float\_ | Unit price | | \`category\_descriptor\` | \_Object\_ | Category description. | | \`passenger\` | \_Object\_ | Additional passenger information. | | \`first\_name\` | \_String\_ | Name | | \`last\_name\` | \_String\_ | Surname | | \`identification\_type\` | \_String\_ | Identification type | | \`identification\_number\` | \_String\_ | Identification number | | \`route\` | \_Object\_ | Route information | | \`departure\` | \_String\_ | Departure | | \`destination\` | \_String\_ | Arrival | | \`departure\_date\_time\` | \_Date\_ | Departure date. Example: 2024-06-20T06:20:00.000-04:00\. | | \`arrival\_date\_time\` | \_Date\_ | Arrival date | | \`company\` | \_String\_ | Company | - Buyer (\_object\_ \`payer\`) | Object \`payer\` | Type | Description | | --- | --- | --- | | \`first\_name\` | \_String\_ | Name | | \`last\_name\` | \_String\_ | Surname | | \`identification\` | \_Object\_ | Identification data | | \`identification\_type\` | \_String\_ | Identification type | | \`identification\_number\` | \_String\_ | Identification number | | \`phone\` | \_Object\_ | Phone | | \`area\_code\` | \_Integer\_ | Area code | | \`number\` | \_Integer\_ | Phone number | | \`address\` | \_Object\_ | Adress data | | \`zip\_code\` | \_String\_ | Postal code | | \`street\_name\` | \_String\_ | Street name | | \`street\_number\` | \_Integer\_ | Street number | | \`authentication\_type\` | \_Enum\_ | Authentication type ("Gmail" - "Facebook" - "Native web" - "Other") | | \`date\_created\` | \_Date\_ | Buyer's registration date on the site. | | \`is\_prime\_user\` | \_Boolean\_ | \`True\` if it is, \`False\` if it is not. | | \`is\_first\_purchase\_online\` | \_Boolean\_ | \`True\` if it is, \`False\` if it is not. | | \`last\_purchase\` | \_Date\_ | Date of the last purchase on the site. | Below, you will find an example of how to send the data presented in the tables above: \`\`\`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": "UYU", "title": "Service", "description": "Service description", "category\_id": "Travels", "category\_descriptor":{ "passenger": { "first\_name": "María Eugenia", "last\_name": "Valentín", "type": "CI", "number": 12345678 }, "route": { "departure": "Montevideo", "destination": "Londres", "departure\_date\_time": "2022-03-12T12:58:41.425-04:00", "arrival\_date\_time": "2022-03-14T12:58:41.425-04:00", "company": "Company" } }, "quantity": 1, "unit\_price": 150 } \], "payer": { "phone": { "area\_code": "11", "number": "656971212" }, "address": { "zip\_code": "52", "street\_name": "Av Libertador Lavalleja", "street\_number": 1000 }, "identification": { "identification\_type": "CI", "identification\_number": "12345678" }, "email": "john@yourdomain.com", "name": "María Eugenia", "surname": "Valentín", "date\_created": "", "authentication\_type": "Facebook", "date\_created": "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 } }' \`\`\` ::: :::AccordionComponent{title="Hospitality"} Add any additional information you consider necessary about: - Items (\_array\_ \`items\`) | Array \`items\` | Type | Description | | --- | --- | --- | | \`id\` | \_String\_ | Code | | \`title\` | \_String\_ | Name | | \`category\_id\` | \_String\_ | Category | | \`quantity\` | \_Integer\_ | Quantity | | \`unit\_price\` | \_Float\_ | Unit price | | \`event\_date\` | \_Date\_ | Event date | | \`category\_descriptor\` | \_Object\_ | Category description | | \`passenger\` | \_Object\_ | Additional passenger information | | \`first\_name\` | \_String\_ | Name | | \`last\_name\` | \_String\_ | Surname | | \`identification\_type\` | \_String\_ | Identification type | | \`identification\_number\` | \_String\_ | Identification number | - Buyer (\_object\_ \`payer\`) | Object \`payer\` | Type | Description | | --- | --- | --- | | \`first\_name\` | \_String\_ | Name | | \`last\_name\` | \_String\_ | Surname | | \`identification\` | \_Object\_ | Identification data | | \`identification\_type\` | \_String\_ | Identification type | | \`identification\_number\` | \_String\_ | Identification number | | \`phone\` | \_Object\_ | Phone | | \`area\_code\` | \_Integer\_ | Area code | | \`number\` | \_Integer\_ | Phone number | | \`address\` | \_Object\_ | Adress data | | \`zip\_code\` | \_String\_ | Postal code | | \`street\_name\` | \_String\_ | Street name | | \`street\_number\` | \_Integer\_ | Street number | | \`authentication\_type\` | \_Enum\_ | Authentication type ("Gmail" - "Facebook" - "Native web" - "Other") | | \`date\_created\` | \_Date\_ | Buyer's registration date on the site. | | \`is\_prime\_user\` | \_Boolean\_ | \`True\` if it is, \`False\` if it is not. | | \`is\_first\_purchase\_online\` | \_Boolean\_ | \`True\` if it is, \`False\` if it is not. | | \`last\_purchase\` | \_Date\_ | Date of the last purchase on the site. | Below, you will find an example of how to send the data presented in the tables above: \`\`\`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": "UYU", "title": "Service", "description": "Service description", "category\_id": "Travels", "category\_descriptor": { "event\_date": "2020-06-02T12:58:41.425-04:00", "passenger": { "first\_name": "María Eugenia", "last\_name": "Valentín", "type": "CI", "number": 12345678 } }, "quantity": 1, "unit\_price": 150 } \], "payer": { "phone": { "area\_code": "11", "number": "656971212" }, "address": { "zip\_code": "52", "street\_name": "Av Libertador Lavalleja", "street\_number": 1000 }, "identification": { "identification\_type": "CI", "identification\_number": "12345678" }, "email": "john@yourdomain.com", "name": "María Eugenia", "surname": "Valentín", "date\_created": "", "authentication\_type": "Facebook", "date\_created": "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 } }' \`\`\` ::: :::AccordionComponent{title="Utilities"} Add any additional information you consider necessary about: - Items (\_array\_ \`items\`) | Array \`items\` | Type | Description | | --- | --- | --- | | \`id\` | \_String\_ | Code | | \`title\` | \_String\_ | Name | | \`category\_id\` | \_String\_ | Category | | \`quantity\` | \_Integer\_ | Quantity | | \`unit\_price\` | \_Float\_ | Unit price | - Buyer (\_object\_ \`payer\`) | Object \`payer\` | Type | Description | | --- | --- | --- | | \`first\_name\` | \_String\_ | Name | | \`last\_name\` | \_String\_ | Surname | | \`identification\` | \_Object\_ | Identification data | | \`identification\_type\` | \_String\_ | Identification type | | \`identification\_number\` | \_String\_ | Identification number | | \`phone\` | \_Object\_ | Phone | | \`area\_code\` | \_Integer\_ | Area code | | \`number\` | \_Integer\_ | Phone number | | \`address\` | \_Object\_ | Adress data | | \`zip\_code\` | \_String\_ | Postal code | | \`street\_name\` | \_String\_ | Street name | | \`street\_number\` | \_Integer\_ | Street number | | \`authentication\_type\` | \_Enum\_ | Authentication type ("Gmail" - "Facebook" - "Native web" - "Other") | | \`date\_created\` | \_Date\_ | Buyer's registration date on the site. | | \`is\_prime\_user\` | \_Boolean\_ | \`True\` if it is, \`False\` if it is not. | | \`is\_first\_purchase\_online\` | \_Boolean\_ | \`True\` if it is, \`False\` if it is not. | | \`last\_purchase\` | \_Date\_ | Date of the last purchase on the site. | Below, you will find an example of how to send the data presented in the tables above: \`\`\`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": "UYU", "title": "Product", "picture\_url": "", "category\_id": "others", "quantity": 1, "unit\_price": 150 } \], "payer": { "phone": { "area\_code": "11", "number": "656971212" }, "address": { "zip\_code": "52", "street\_name": "Av Libertador Lavalleja", "street\_number": 1000 }, "identification": { "identification\_type": "CI", "identification\_number": "12345678" }, "email": "john@yourdomain.com", "name": "María Eugenia", "surname": "Valentín", "date\_created": "", "authentication\_type": "Facebook", "date\_created": "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 } }' \`\`\` ::: :::AccordionComponent{title="Direct sale"} Add any additional information you consider necessary about: - Items (\_array\_ \`items\`) | Array \`items\` | Type | Description | | --- | --- | --- | | \`id\` | \_String\_ | Code | | \`title\` | \_String\_ | Name | | \`description\` | \_String\_ | Description | | \`category\_id\` | \_String\_ | Category | | \`quantity\` | \_Integer\_ | Quantity | | \`unit\_price\` | \_Float\_ | Unit price | - Buyer (\_object\_ \`payer\`) | Object \`payer\` | Type | Description | | --- | --- | --- | | \`first\_name\` | \_String\_ | Name | | \`last\_name\` | \_String\_ | Surname | | \`identification\` | \_Object\_ | Identification data | | \`identification\_type\` | \_String\_ | Identification type | | \`identification\_number\` | \_String\_ | Identification number | | \`phone\` | \_Object\_ | Phone | | \`area\_code\` | \_Integer\_ | Area code | | \`number\` | \_Integer\_ | Phone number | | \`address\` | \_Object\_ | Adress data | | \`zip\_code\` | \_String\_ | Postal code | | \`street\_name\` | \_String\_ | Street name | | \`street\_number\` | \_Integer\_ | Street number | | \`authentication\_type\` | \_Enum\_ | Authentication type ("Gmail" - "Facebook" - "Native web" - "Other") | | \`date\_created\` | \_Date\_ | Buyer's registration date on the site. | | \`is\_prime\_user\` | \_Boolean\_ | \`True\` if it is, \`False\` if it is not. | | \`is\_first\_purchase\_online\` | \_Boolean\_ | \`True\` if it is, \`False\` if it is not. | | \`last\_purchase\` | \_Date\_ | Date of the last purchase on the site. | - Shipments (\_object\_ \`shipment\`) | Object \`shipment\` | Type | Description | | --- | --- | --- | | \`receiver\_address\` | \_Object\_ | Address of the buyer. | | \`zip\_code\` | \_String\_ | Postal code | | \`state\_name\` | \_String\_ | Province | | \`city\_name\` | \_String\_ | City | | \`street\_number\` | \_Integer\_ | Street number | | \`floor\` | \_String\_ | Floor | | \`apartment\` | \_String\_ | Apartament | | \`local\_pickup\` | \_Boolean\_ | \`True\` if withdrawn at branch, \`False\` if not. | Below, you will find an example of how to send the data presented in the tables above: \`\`\`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": "UYU", "title": "Product", "picture\_url": "", "description": "Product description", "category\_id": "others", "quantity": 1, "unit\_price": 150 } \], "payer": { "phone": { "area\_code": "11", "number": "656971212" }, "address": { "zip\_code": "52", "street\_name": "Av Libertador Lavalleja", "street\_number": 1000 }, "identification": { "identification\_type": "CI", "identification\_number": "12345678" }, "email": "john@yourdomain.com", "name": "María Eugenia", "surname": "Valentín", "date\_created": "", "authentication\_type": "Facebook", "date\_created": "2015-06-02T12:58:41.425-04:00", "is\_prime\_user": false, "is\_first\_purchase\_online": false, "last\_purchase": "2020-01-02T12:58:41.425-04:00" }, "payment\_methods": { "excluded\_payment\_methods": \[ { "id": "" } \], "default\_installments": null, "default\_payment\_method\_id": null, "excluded\_payment\_types": \[ { "id": "" } \], "installments": null }, "shipments": { "mode": "not\_specified", "local\_pickup": false, "receiver\_address": { "zip\_code": "52", "street\_name": "Av Libertador Lavalleja", "city\_name": "Montevideo", "state\_name": "Montevideo", "street\_number": 1000 "floor": "12", "apartment": "B" } } }' \`\`\` ::: :::AccordionComponent{title="Automobiles and nautical"} Add any additional information you consider necessary about: - Items (\_array\_ \`items\`) | Array \`items\` | Type | Description | | --- | --- | --- | | \`id\` | \_String\_ | Code | | \`title\` | \_String\_ | Name | | \`description\` | \_String\_ | Description | | \`category\_id\` | \_String\_ | Category | | \`quantity\` | \_Integer\_ | Quantity | | \`unit\_price\` | \_Float\_ | Unit price | - Buyer (\_object\_ \`payer\`) | Object \`payer\` | Type | Description | | --- | --- | --- | | \`first\_name\` | \_String\_ | Name | | \`last\_name\` | \_String\_ | Surname | | \`identification\` | \_Object\_ | Identification data | | \`identification\_type\` | \_String\_ | Identification type | | \`identification\_number\` | \_String\_ | Identification number | | \`phone\` | \_Object\_ | Phone | | \`area\_code\` | \_Integer\_ | Area Code | | \`number\` | \_Integer\_ | Phone number | | \`address\` | \_Object\_ | Adress data | | \`zip\_code\` | \_String\_ | Postal code | | \`street\_name\` | \_String\_ | Street name | | \`street\_number\` | \_Integer\_ | Street number | | \`authentication\_type\` | \_Enum\_ | Authentication type ("Gmail" - "Facebook" - "Native web" - "Other") | | \`date\_created\` | \_Date\_ | Buyer's registration date on the site. | | \`is\_first\_purchase\_online\` | \_Boolean\_ | \`True\` if it is, \`False\` if it is not. | | \`last\_purchase\` | \_Date\_ | Date of the last purchase on the site. | - Shipments (\_object\_ \`shipment\`) | Object \`shipment\` | Type | Description | | --- | --- | --- | | \`receiver\_address\` | \_Object\_ | Address of the buyer. | | \`zip\_code\` | \_String\_ | Postal code | | \`state\_name\` | \_String\_ | Province | | \`city\_name\` | \_String\_ | City | | \`street\_number\` | \_Integer\_ | Street number | | \`floor\` | \_String\_ | Floor | | \`apartment\` | \_String\_ | Apartament | | \`local\_pickup\` | \_Boolean\_ | \`True\` if withdrawn at branch, \`False\` if not. | Below, you will find an example of how to send the data presented in the tables above: \`\`\`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": "UYU", "title": "Product", "picture\_url": "", "description": "Product Description", "category\_id": "others", "quantity": 1, "unit\_price": 150 } \], "payer": { "phone": { "area\_code": "11", "number": "656971212" }, "address": { "zip\_code": "52", "street\_name": "Av Libertador Lavalleja", "street\_number": 1000 }, "identification": { "identification\_type": "CI", "identification\_number": "12345678" }, "email": "john@yourdomain.com", "name": "María Eugenia", "surname": "Valentín", "date\_created": "", "authentication\_type": "Facebook", "date\_created": "2015-06-02T12:58:41.425-04:00", "is\_first\_purchase\_online": false, "last\_purchase": "2020-01-02T12:58:41.425-04:00" }, "payment\_methods": { "excluded\_payment\_methods": \[ { "id": "" } \], "default\_installments": null, "default\_payment\_method\_id": null, "excluded\_payment\_types": \[ { "id": "" } \], "installments": null }, "shipments": { "mode": "not\_specified", "local\_pickup": false, "receiver\_address": { "zip\_code": "52", "street\_name": "Av Libertador Lavalleja", "city\_name": "Montevideo", "state\_name": "Montevideo", "street\_number": 1000 "floor": "12", "apartment": "B" } } }' \`\`\` ::: :::AccordionComponent{title="Urban transport"} Add any additional information you consider necessary about: - Items (\_array\_ \`items\`) | Array \`items\` | Type | Description | | --- | --- | --- | | \`id\` | \_String\_ | Code | | \`title\` | \_String\_ | Name | | \`description\` | \_String\_ | Description | | \`category\_id\` | \_String\_ | Category | | \`quantity\` | \_Integer\_ | Quantity | | \`unit\_price\` | \_Float\_ | Unit price | - Buyer (\_object\_ \`payer\`) | Object \`payer\` | Type | Description | | --- | --- | --- | | \`first\_name\` | \_String\_ | Name | | \`last\_name\` | \_String\_ | Surname | | \`identification\` | \_Object\_ | Identification data | | \`identification\_type\` | \_String\_ | Identification type | | \`identification\_number\` | \_String\_ | Identification number | | \`phone\` | \_Object\_ | Phone | | \`area\_code\` | \_Integer\_ | Area Code | | \`number\` | \_Integer\_ | Phone number | | \`address\` | \_Object\_ | Adress data | | \`zip\_code\` | \_String\_ | Postal code | | \`street\_name\` | \_String\_ | Street name | | \`street\_number\` | \_Integer\_ | Street number | | \`authentication\_type\` | \_Enum\_ | Authentication type ("Gmail" - "Facebook" - "Native web" - "Other") | | \`date\_created\` | \_Date\_ | Buyer's registration date on the site. | | \`is\_prime\_user\` | \_Boolean\_ | \`True\` if it is, \`False\` if it is not. | | \`is\_first\_purchase\_online\` | \_Boolean\_ | \`True\` if it is, \`False\` if it is not. | | \`last\_purchase\` | \_Date\_ | Date of the last purchase on the site. | Below, you will find an example of how to send the data presented in the tables above: \`\`\`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": "UYU", "title": "Product", "picture\_url": "", "description": "Product Description", "category\_id": "others", "quantity": 1, "unit\_price": 150 } \], "payer": { "phone": { "area\_code": "11", "number": "656971212" }, "address": { "zip\_code": "52", "street\_name": "Av Libertador Lavalleja", "street\_number": 1000 }, "identification": { "identification\_type": "CI", "identification\_number": "12345678" }, "email": "john@yourdomain.com", "name": "María Eugenia", "surname": "Valentín", "date\_created": "", "authentication\_type": "Facebook", "date\_created": "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 } }' \`\`\` ::: :::AccordionComponent{title="Gambling"} Add any additional information you consider necessary about: - Items (\_array\_ \`items\`) | Array \`items\` | Type | Description | | --- | --- | --- | | \`id\` | \_String\_ | Item identification code. | | \`title\` | \_String\_ | Item name. | | \`warranty\` | \_Boolean\_ | \`true\` if it is, \`false\` if it is not. | | \`category\_id\` | \_String\_ | Item category. | | \`quantity\` | \_Integer\_ | Quantity of units for the item. | | \`unit\_price\` | \_Float\_ | Unit price assigned to the item. It can be an integer or a decimal. | - Buyer (\_object\_ \`payer\`) | Object \`payer\` | Type | Description | | --- | --- | --- | | \`first\_name\` | \_String\_ | Buyer's first name. | | \`last\_name\` | \_String\_ | Buyer's last name. | | \`identification\` | \_Object\_ | Buyer's identification data. | | \`type\` | \_String\_ | Type of identification. It is found within the \`identification\` object. | | \`number\` | \_String\_ | Identification number. It is found within the \`identification\` object. | | \`phone\` | \_Object\_ | Buyer's phone number. | | \`area\_code\` | \_Integer\_ | Buyer's area code. It is found within the \`phone\` object. | | \`number\` | \_Integer\_ | Buyer's phone number. It is found within the \`phone\` object. | | \`address\` | \_Object\_ | Buyer's address data. | | \`zip\_code\` | \_String\_ | Buyer's postal code. It is found within the \`address\` object. | | \`street\_name\` | \_String\_ | Street name of the buyer's address. It is found within the \`address\` object. | | \`street\_number\` | \_Integer\_ | Street number of the buyer's address. It is found within the \`address\` object. | | \`authentication\_type\` | \_Enum\_ | Type of authentication. It can be "Gmail", "Facebook", "Native Web", or "Other". | | \`date\_created\` | \_Date\_ | Buyer's registration date on the site. | | \`is\_prime\_user\` | \_Boolean\_ | Indicates if the user is premium. Put \`true\` if they are or \`false\` if they are not. | | \`is\_first\_purchase\_online\` | \_Boolean\_ | Indicates if this is the customer's first purchase. Put \`true\` if they are or \`false\` if they are not. | | \`last\_purchase\` | \_Date\_ | Date of the last purchase on the site. | Below, you will find an example of how to send the data presented in the tables above: \`\`\`curl curl --location 'https://api.mercadopago.com/checkout/preferences' \\ --header 'Content-Type: application/json' \\ --header 'Authorization: Bearer {{access\_token}}' \\ --data-raw '{ "auto\_return": "approved", "back\_urls": { "failure": "https://www.mercadopago.com/home/failure", "pending": "https://www.mercadopago.com/home/pending", "success": "https://www.mercadopago.com/home/success" }, "notification\_url": "https://webhook.site/xyz", "expires": false, "external\_reference": "order-123", "date\_of\_expiration": "2026-03-12T12:58:41.425-04:00", "items": \[ { "id": "1234", "currency\_id": "MXN", "title": "Producto", "picture\_url": "", "description": "Descripción de producto", "category\_id": "lottery", "quantity": 1, "unit\_price": 150 } \], "payer": { "phone": { "area\_code": "11", "number": "619 911 306" }, "address": { "zip\_code": "52", "street\_name": "Insurgentes Sur", "street\_number": 1000 }, "identification": { "identification\_type": "-", "identification\_number": "12345678" }, "email": "carlota.castellanos@yourdomain.com", "name": "Carlota", "surname": "Castellanos", "date\_created": "", "authentication\_type": "Facebook", "date\_created": "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 } }' \`\`\` :::