# MD for: https://www.mercadopago.com.br/developers/es/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": "BRL", "title": "Product", "picture\_url": "", "description": "Product Description", "type": "test", "category\_id": "fashion", "quantity": 1, "unit\_price": 150 } \], "payer": { "phone": { "area\_code": "11", "number": "987654321" }, "address": { "zip\_code": "52", "street\_name": "Av. das Nações Unidas", "street\_number": 1000 }, "identification": { "identification\_type": "CPF", "identification\_number": "12345678" }, "email": "john@yourdomain.com", "first\_name": "Maria", "last\_name": "Silva", "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. das Nações Unidas", "city\_name": "Osasco", "state\_name": "São Paulo", "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": "BRL", "title": "Product", "category\_id": "phones", "quantity": 1, "unit\_price": 150, "warranty": false, } \], "payer": { "phone": { "area\_code": "11", "number": "987654321" }, "address": { "zip\_code": "52", "street\_name": "Av. das Nações Unidas", "street\_number": 1000 }, "identification": { "identification\_type": "CPF", "identification\_number": "12345678" }, "email": "john@yourdomain.com”, "first\_name": "Maria", "last\_name": "Silva", "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. das Nações Unidas", "city\_name": "Osasco", "state\_name": "São Paulo", "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": "BRL", "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": "987654321" }, "identification": { "identification\_type": "CPF", "identification\_number": "12345678" }, "email": "john@yourdomain.com", "first\_name": "Maria", "last\_name": "Silva", "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. das Nações Unidas", "city\_name": "Osasco", "state\_name": "São Paulo", "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": "BRL", "title": "Product", "picture\_url": "", "description": "Product Description", "category\_id": "home", "quantity": 1, "unit\_price": 150, "warranty": false, } \], "payer": { "phone": { "area\_code": "11", "number": "987654321" }, "address": { "zip\_code": "52", "street\_name": "Av. das Nações Unidas", "street\_number": 1000 }, "identification": { "identification\_type": "CPF", "identification\_number": "12345678" }, "email": "john@yourdomain.com", "first\_name": "Maria", "last\_name": "Silva", "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. das Nações Unidas", "city\_name": "Osasco", "state\_name": "São Paulo", "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": "BRL", "title": "Product", "picture\_url": "", "description": "Product Description", "category\_id": "services", "quantity": 1, "unit\_price": 150 } \], "payer": { "phone": { "area\_code": "11", "number": "987654321" }, "address": { "zip\_code": "52", "street\_name": "Av. das Nações Unidas", "street\_number": 1000 }, "identification": { "identification\_type": "CPF", "identification\_number": "12345678" }, "email": "john@yourdomain.com", "name": "Maria", "surname": "Silva", "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": "BRL", "title": "Product", "picture\_url": "", "description": "Product Description", "category\_id": "others", "quantity": 1, "unit\_price": 150 } \], "payer": { "phone": { "area\_code": "11", "number": "987654321" }, "address": { "zip\_code": "52", "street\_name": "Av. das Nações Unidas", "street\_number": 1000 }, "identification": { "identification\_type": "CPF", "identification\_number": "12345678" }, "email": "john@yourdomain.com", "name": "Maria", "surname": "Silva", "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. das Nações Unidas", "city\_name": "Osasco", "state\_name": "São Paulo", "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": "BRL", "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": "987654321" }, "address": { "zip\_code": "52", "street\_name": "Av. das Nações Unidas", "street\_number": 1000 }, "identification": { "identification\_type": "CPF", "identification\_number": "12345678" }, "email": "john@yourdomain.com", "name": "Maria", "surname": "Silva", "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. das Nações Unidas", "city\_name": "Osasco", "state\_name": "São Paulo", "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": "BRL", "title": "Service", "description": "Service description", "category\_id": "Travels", "category\_descriptor":{ "passenger": { "first\_name": "Maria", "last\_name": "Silva", "type": "CPF", "number": 12345678 }, "route": { "departure": "Osasco", "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": "987654321" }, "address": { "zip\_code": "52", "street\_name": "Av. das Nações Unidas", "street\_number": 1000 }, "identification": { "identification\_type": "CPF", "identification\_number": "12345678" }, "email": "john@yourdomain.com", "name": "Maria", "surname": "Silva", "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": "BRL", "title": "Service", "description": "Service description", "category\_id": "Travels", "category\_descriptor": { "event\_date": "2020-06-02T12:58:41.425-04:00", "passenger": { "first\_name": "Maria", "last\_name": "Silva", "type": "CPF", "number": 12345678 } }, "quantity": 1, "unit\_price": 150 } \], "payer": { "phone": { "area\_code": "11", "number": "987654321" }, "address": { "zip\_code": "52", "street\_name": "Av. das Nações Unidas", "street\_number": 1000 }, "identification": { "identification\_type": "CPF", "identification\_number": "12345678" }, "email": "john@yourdomain.com", "name": "Maria", "surname": "Silva", "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": "BRL", "title": "Product", "picture\_url": "", "category\_id": "others", "quantity": 1, "unit\_price": 150 } \], "payer": { "phone": { "area\_code": "11", "number": "987654321" }, "address": { "zip\_code": "52", "street\_name": "Av. das Nações Unidas", "street\_number": 1000 }, "identification": { "identification\_type": "CPF", "identification\_number": "12345678" }, "email": "john@yourdomain.com", "name": "Maria", "surname": "Silva", "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": "BRL", "title": "Product", "picture\_url": "", "description": "Product description", "category\_id": "others", "quantity": 1, "unit\_price": 150 } \], "payer": { "phone": { "area\_code": "11", "number": "987654321" }, "address": { "zip\_code": "52", "street\_name": "Av. das Nações Unidas", "street\_number": 1000 }, "identification": { "identification\_type": "CPF", "identification\_number": "12345678" }, "email": "john@yourdomain.com", "name": "Maria", "surname": "Silva", "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. das Nações Unidas", "city\_name": "Osasco", "state\_name": "São Paulo", "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": "BRL", "title": "Product", "picture\_url": "", "description": "Product Description", "category\_id": "others", "quantity": 1, "unit\_price": 150 } \], "payer": { "phone": { "area\_code": "11", "number": "987654321" }, "address": { "zip\_code": "52", "street\_name": "Av. das Nações Unidas", "street\_number": 1000 }, "identification": { "identification\_type": "CPF", "identification\_number": "12345678" }, "email": "john@yourdomain.com", "name": "Maria", "surname": "Silva", "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. das Nações Unidas", "city\_name": "Osasco", "state\_name": "São Paulo", "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": "BRL", "title": "Product", "picture\_url": "", "description": "Product Description", "category\_id": "others", "quantity": 1, "unit\_price": 150 } \], "payer": { "phone": { "area\_code": "11", "number": "987654321" }, "address": { "zip\_code": "52", "street\_name": "Av. das Nações Unidas", "street\_number": 1000 }, "identification": { "identification\_type": "CPF", "identification\_number": "12345678" }, "email": "john@yourdomain.com", "name": "Maria", "surname": "Silva", "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 } }' \`\`\` :::