diff --git a/guides/checkout-api-v2/industry-data/apparel.en.md b/guides/checkout-api-v2/industry-data/apparel.en.md new file mode 100644 index 0000000000..2e9bdfb876 --- /dev/null +++ b/guides/checkout-api-v2/industry-data/apparel.en.md @@ -0,0 +1,144 @@ +# Apparel + +These are the specific data for the **apparel** industry that you can add to your integration to improve payment approval. + +## Fields to send + +Add any additional information that you consider necessary. + +### About the items + +----[mla, mlm, mlu, mco, mlb, mpe]---- +| Array `items` | Type | Description | +| --- | --- | --- | +| `id` | String | Item identification code. | +| `title` | String | Item name. | +| `type` | String | Item type. | +| `description` | String | Item description. | +| `picture_url` | String | Image URL representing the item. | +| `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. | +------------ + +----[mlc]---- +| Array `items` | Type | Description | +| --- | --- | --- | +| `id` | String | Item identification code. | +| `title` | String | Item name. | +| `type` | String | Item type. | +| `description` | String | Item description. | +| `picture_url` | String | Image URL representing the item. | +| `category_id` | String | Item category. | +| `quantity` | Integer | Quantity of units for the item. | +| `unit_price` | Float | Unit price assigned to the item. It must be an integer. | +------------ + +### About the buyer + +| 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". | +| `registration_date` | 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. | + +### About Shipments + +| Object `shipment` | Type | Description | +| --- | --- | --- | +| `receiver_address` | Object | Shipping address data. | +| `zip_code` | String | Postal code for the shipment. | +| `state_name` | String | Province to which the order is shipped. | +| `city_name` | String | City to which the order is shipped. | +| `street_number` | Integer | Street number of the shipment. | +| `express_shipment` | Boolean | Indicates if the shipment is express. `true` if it is, `false` if it is not. | + +```curl +curl --location 'https://api.mercadopago.com/v1/payments' \ +--header 'Content-Type: application/json' \ +--header 'X-Idempotency-Key: {{uuid}} \ +--header 'Authorization: Bearer ACCESS_TOKEN' \ +--header 'X-Meli-Session-Id: {{device_id}}' \ +--data-raw '{ + "transaction_amount": 150.00, + "installments": 1, + "statement_descriptor": "LOJA 123", + "capture": true, + "binary_mode": false, + "sponsor_id": null, + "application_fee": null, + "payment_method_id": "debvisa", + "token": "{{card_token_id}}", + "external_reference": "Pedido01", + "description": "PEDIDO NOVO", + "notification_url": "{{notification_url}}", + "metadata": { + "order_number": "order_01" + }, + "payer": { + "email": "test_user_123456789@testuser.com", + "identification": { + "type": "CPF", + "number": "12345678909" + } + }, + "additional_info": { + "items": [ + { + "id": "1234", + "title": "Serviço", + "type": "my_items_type", + "picture_url": "{{url_image}}", + "description": "Descrição de serviço", + "category_id": "fashion", + "quantity": 1, + "unit_price": 150 + } + ], + "payer": { + "first_name": "Nome", + "last_name": "Sobrenome", + "is_prime_user": "1", + "is_first_purchase_online": "1", + "last_purchase": "2019-10-25T19:30:00.000-03:00", + "phone": { + "area_code": "11", + "number": "987654321" + }, + "address": { + "zip_code": "206233-2002", + "street_name": "Av. das Nações Unidas", + "street_number": "3003" + }, + "authentication_type": "Facebook", + "registration_date": "2020-08-06T09:25:04.000-03:00" + }, + "shipments": { + "express_shipment": true, + "receiver_address": { + "zip_code": "306233-2003", + "street_name": "Av. das Nações Unidas", + "street_number": "3003", + "floor": "5", + "apartment": "502", + "state_name":"SP", + "city_name":"Osasco" + } + } + } +}' +``` \ No newline at end of file diff --git a/guides/checkout-api-v2/industry-data/apparel.es.md b/guides/checkout-api-v2/industry-data/apparel.es.md new file mode 100644 index 0000000000..d8fb361414 --- /dev/null +++ b/guides/checkout-api-v2/industry-data/apparel.es.md @@ -0,0 +1,145 @@ +# Apparel + +Estos son los datos específicos para la industria **apparel** que puedes agregar a tu integración para mejorar la aprobación de los pagos. + +## Campos a enviar + +Agrega toda la información adicional que consideres necesaria. + +### Sobre los ítems + +----[mla, mlm, mlu, mco, mlb, mpe]---- +| Array `items` | Tipo | Descripción | +| --- | --- | --- | +| `id` | String | Código de identificación del ítem. | +| `title` | String | Nombre del ítem. | +| `type` | String | Tipo de ítem. | +| `description` | String | Descripción del ítem. | +| `picture_url` | String | URL de imagen que representa al ítem. | +| `category_id` | String | Categoría del ítem. | +| `quantity` | Integer | Cantidad de unidades para el ítem. | +| `unit_price` | Float | Precio unitario asignado al ítem. Puede ser entero o con decimales. | +------------ + +----[mlc]---- +| Array `items` | Tipo | Descripción | +| --- | --- | --- | +| `id` | String | Código de identificación del ítem. | +| `title` | String | Nombre del ítem. | +| `type` | String | Tipo de ítem. | +| `description` | String | Descripción del ítem. | +| `picture_url` | String | URL de imagen que representa al ítem. | +| `category_id` | String | Categoría del ítem. | +| `quantity` | Integer | Cantidad de unidades para el ítem. | +| `unit_price` | Float | Precio unitario asignado al ítem. Debe ser un número entero. | +------------ + +### Sobre el comprador + +| Object `payer` | Tipo | Descripción | +| --- | --- | --- | +| `first_name` | String | Nombre del comprador. | +| `last_name` | String | Apellido del comprador. | +| `identification` | Object | Datos de identificación del comprador. | +| `type` | String | Tipo de identificación. Se encuentra dentro del objeto `identification`. | +| `number` | String | Número de identificación. Se encuentra dentro del objeto `identification`. | +| `phone` | Object | Teléfono del comprador. | +| `area_code` | Integer | Código de área del comprador. Se encuentra dentro del objeto `phone`. | +| `number` | Integer | Número de teléfono del comprador. Se encuentra dentro del objeto `phone`. | +| `address` | Object | Datos del domicilio del comprador. | +| `zip_code` | String | Código postal del comprador. Se encuentra dentro del objeto `address`. | +| `street_name` | String | Nombre de calle del domicilio del comprador. Se encuentra dentro del objeto `address`. | +| `street_number` | Integer | Número de calle del domicilio del comprador. Se encuentra dentro del objeto `address`. | +| `authentication_type` | Enum | Tipo de autenticación. Pueden ser "Gmail", "Facebook", "Web Nativa" u "Otro". | +| `registration_date` | Date | Fecha de registro del comprador en el sitio. | +| `is_prime_user` | Boolean | Indica si el usuario es premium. Coloca `true` si lo es o `false` si no lo es. | +| `is_first_purchase_online` | Boolean | Indica si es la primera compra del cliente. Coloca `true` si lo es o `false` si no lo es. | +| `last_purchase` | Date | Fecha de la última compra en el sitio. | + +### Sobre envíos + +| Object `shipment` | Tipo | Descripción | +| --- | --- | --- | +| `receiver_address` | Object | Datos de dirección del envío. | +| `zip_code` | String | Código postal para el envío. | +| `state_name` | String | Provincia hacia donde se envía el pedido. | +| `city_name` | String | Ciudad hacia donde se envía el pedido. | +| `street_number` | Integer | Número de calle del envío. | +| `express_shipment` | Boolean | Indica si el envío es rápido. `true` si lo es, `false` si no lo es. | + +```curl +curl --location 'https://api.mercadopago.com/v1/payments' \ +--header 'Content-Type: application/json' \ +--header 'X-Idempotency-Key: {{uuid}} \ +--header 'Authorization: Bearer ACCESS_TOKEN' \ +--header 'X-Meli-Session-Id: {{device_id}}' \ +--data-raw '{ + "transaction_amount": 150.00, + "installments": 1, + "statement_descriptor": "LOJA 123", + "capture": true, + "binary_mode": false, + "sponsor_id": null, + "application_fee": null, + "payment_method_id": "debvisa", + "token": "{{card_token_id}}", + "external_reference": "Pedido01", + "description": "PEDIDO NOVO", + "notification_url": "{{notification_url}}", + "metadata": { + "order_number": "order_01" + }, + "payer": { + "email": "test_user_123456789@testuser.com", + "identification": { + "type": "CPF", + "number": "12345678909" + } + }, + "additional_info": { + "items": [ + { + "id": "1234", + "title": "Serviço", + "type": "my_items_type", + "picture_url": "{{url_image}}", + "description": "Descrição de serviço", + "category_id": "fashion", + "quantity": 1, + "unit_price": 150 + } + ], + "payer": { + "first_name": "Nome", + "last_name": "Sobrenome", + "is_prime_user": "1", + "is_first_purchase_online": "1", + "last_purchase": "2019-10-25T19:30:00.000-03:00", + "phone": { + "area_code": "11", + "number": "987654321" + }, + "address": { + "zip_code": "206233-2002", + "street_name": "Av. das Nações Unidas", + "street_number": "3003" + }, + "authentication_type": "Facebook", + "registration_date": "2020-08-06T09:25:04.000-03:00" + }, + "shipments": { + "express_shipment": true, + "receiver_address": { + "zip_code": "306233-2003", + "street_name": "Av. das Nações Unidas", + "street_number": "3003", + "floor": "5", + "apartment": "502", + "state_name":"SP", + "city_name":"Osasco" + } + } + } +}' +``` + diff --git a/guides/checkout-api-v2/industry-data/apparel.pt.md b/guides/checkout-api-v2/industry-data/apparel.pt.md new file mode 100644 index 0000000000..1bf1ddd376 --- /dev/null +++ b/guides/checkout-api-v2/industry-data/apparel.pt.md @@ -0,0 +1,144 @@ +# Apparel + +Estes são os dados específicos para a indústria de **apparel** que podem ser adicionados à sua integração para melhorar a aprovação dos pagamentos. + +## Campos para enviar + +Adicione qualquer informação extra que considerar necessária. + +### Sobre itens + +----[mla, mlm, mlu, mco, mlb, mpe]---- +| Array `items` | Tipo | Descrição| +| --- | --- | --- | +| `id` | String | Código de identificação do item. | +| `title` | String | Nome do item. | +| `type` | String | Tipo de item. | +| `description` | String | Descrição do item. | +| `picture_url` | String | URL da imagem que representa o item. | +| `category_id` | String | Categoria do item. | +| `quantity` | Integer | Quantidade de unidades do item. | +| `unit_price` | Float | Preço unitário atribuído ao item. Pode ser um valor inteiro ou em casas decimais. | +------------ + +----[mlc]---- +| Array `items` | Tipo | Descrição| +| --- | --- | --- | +| `id` | String | Código de identificação do item. | +| `title` | String | Nome do item. | +| `type` | String | Tipo de item. | +| `description` | String | Descrição do item. | +| `picture_url` | String | URL da imagem que representa o item. | +| `category_id` | String | Categoria do item. | +| `quantity` | Integer | Quantidade de unidades do item. | +| `unit_price` | Float | Preço unitário atribuído ao item. Deve ser um valor inteiro. | +------------ + +### Sobre o comprador + +| Object `payer` | Tipo | Descrição | +| --- | --- | --- | +| `first_name` | String | Nome do comprador. | +| `last_name` | String | Sobrenome do comprador. | +| `identification` | Object | Dados de identificação do comprador. | +| `type` | String | Tipo de identificação. Está dentro do objeto `identification`. | +| `number` | String | Número de identificação. Está dentro do objeto `identification`. | +| `phone` | Object | Telefone do comprador. | +| `area_code` | Integer | Código de área do comprador. Está dentro do objeto `phone`. | +| `number` | Integer | Número de telefone do comprador. Está dentro do objeto `phone`. | +| `address` | Object | Dados do endereço do comprador. | +| `zip_code` | String | Código postal do comprador. Está dentro do objeto `address`. | +| `street_name` | String | Nome da rua do endereço do comprador. Está dentro do objeto `address`. | +| `street_number` | Integer | Número da rua do endereço do comprador. Está dentro do objeto `address`. | +| `authentication_type` | Enum | Tipo de autenticação. Pode ser "Gmail", "Facebook", "Web Nativa" ou "Outro". | +| `registration_date` | Date | Data de registro do comprador no site. | +| `is_prime_user` | Boolean | Indica se o usuário é *premium*. Caso seja, use `true` e, caso não seja, use `false`. | +| `is_first_purchase_online` | Boolean | Indica se é a primeira compra do cliente. Caso seja, use `true` e, caso não seja, use `false`. | +| `last_purchase` | Date | Data da última compra no site. | + +### Sobre remessa + +| Object `shipment` | Tipo | Descrição | +| --- | --- | --- | +| `receiver_address` | Object | Dados do endereço da entrega. | +| `zip_code` | String | Código postal para a entrega. | +| `state_name` | String | Estado para onde o pedido é enviado. | +| `city_name` | String | Cidade para onde o pedido é enviado. | +| `street_number` | Integer | Número da rua da entrega. | +| `express_shipment` | Boolean | Indica se a entrega é expressa. Caso seja, use `true` e, caso não seja, use `false`. | + +```curl +curl --location 'https://api.mercadopago.com/v1/payments' \ +--header 'Content-Type: application/json' \ +--header 'X-Idempotency-Key: {{uuid}} \ +--header 'Authorization: Bearer ACCESS_TOKEN' \ +--header 'X-Meli-Session-Id: {{device_id}}' \ +--data-raw '{ + "transaction_amount": 150.00, + "installments": 1, + "statement_descriptor": "LOJA 123", + "capture": true, + "binary_mode": false, + "sponsor_id": null, + "application_fee": null, + "payment_method_id": "debvisa", + "token": "{{card_token_id}}", + "external_reference": "Pedido01", + "description": "PEDIDO NOVO", + "notification_url": "{{notification_url}}", + "metadata": { + "order_number": "order_01" + }, + "payer": { + "email": "test_user_123456789@testuser.com", + "identification": { + "type": "CPF", + "number": "12345678909" + } + }, + "additional_info": { + "items": [ + { + "id": "1234", + "title": "Serviço", + "type": "my_items_type", + "picture_url": "{{url_image}}", + "description": "Descrição de serviço", + "category_id": "fashion", + "quantity": 1, + "unit_price": 150 + } + ], + "payer": { + "first_name": "Nome", + "last_name": "Sobrenome", + "is_prime_user": "1", + "is_first_purchase_online": "1", + "last_purchase": "2019-10-25T19:30:00.000-03:00", + "phone": { + "area_code": "11", + "number": "987654321" + }, + "address": { + "zip_code": "206233-2002", + "street_name": "Av. das Nações Unidas", + "street_number": "3003" + }, + "authentication_type": "Facebook", + "registration_date": "2020-08-06T09:25:04.000-03:00" + }, + "shipments": { + "express_shipment": true, + "receiver_address": { + "zip_code": "306233-2003", + "street_name": "Av. das Nações Unidas", + "street_number": "3003", + "floor": "5", + "apartment": "502", + "state_name":"SP", + "city_name":"Osasco" + } + } + } +}' +``` \ No newline at end of file diff --git a/guides/checkout-api-v2/industry-data/applications-online-platforms.en.md b/guides/checkout-api-v2/industry-data/applications-online-platforms.en.md new file mode 100644 index 0000000000..c7a598463e --- /dev/null +++ b/guides/checkout-api-v2/industry-data/applications-online-platforms.en.md @@ -0,0 +1,112 @@ +# Applications and online platforms + +These are the specific data for the **applications and online platforms** industry that you can add to your integration to improve payment approval. + +## Fields to send + +Add any additional information that you consider necessary. + +### About the items + +----[mla, mlm, mlu, mco, mlb, mpe]---- +| Array `items` | Type | Description | +| --- | --- | --- | +| `id` | String | Item identification code. | +| `title` | String | Item name. | +| `category_id` | String | Category of the item. | +| `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. | +------------ + +----[mlc]---- +| Array `items` | Type | Description | +| --- | --- | --- | +| `id` | String | Item identification code. | +| `title` | String | Item name. | +| `category_id` | String | Category of the item. | +| `quantity` | Integer | Quantity of units for the item. | +| `unit_price` | Float | Unit price assigned to the item. It must be an integer. | +----------- + +### About the buyer + +| 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". | +| `registration_date` | 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. | + +```curl +curl --location 'https://api.mercadopago.com/v1/payments' \ +--header 'Content-Type: application/json' \ +--header 'X-Idempotency-Key: {{uuid}}' \ +--header 'Authorization: Bearer ACCESS_TOKEN' \ +--header 'X-Meli-Session-Id: {{device_id}} \ +--data-raw '{ + "transaction_amount": 150.00, + "installments": 1, + "statement_descriptor": "LOJA 123", + "capture": true, + "binary_mode": false, + "sponsor_id": null, + "application_fee": null, + "payment_method_id": "debvisa", + "token": "{{card_token_id}}", + "external_reference": "Pedido01", + "description": "PEDIDO NOVO", + "notification_url": "{{notification_url}}", + "metadata": { + "order_number": "order_01" + }, + "payer": { + "email": "test_user_123456789@testuser.com", + "identification": { + "type": "CPF", + "number": "12345678909" + } + }, + "additional_info": { + "items": [ + { + "id": "1234", + "title": "Serviço", + "category_id": "games", + "quantity": 1, + "unit_price": 150 + } + ], + "payer": { + "first_name": "Nome", + "last_name": "Sobrenome", + "is_prime_user": "1", + "is_first_purchase_online": "1", + "last_purchase": "2019-10-25T19:30:00.000-03:00", + "phone": { + "area_code": "11", + "number": "987654321" + }, + "address": { + "zip_code": "206233-2002", + "street_name": "Av. das Nações Unidas", + "street_number": "230032" + }, + "authentication_type": "Facebook", + "registration_date": "2020-08-06T09:25:04.000-03:00" + } + } +}' +``` \ No newline at end of file diff --git a/guides/checkout-api-v2/industry-data/applications-online-platforms.es.md b/guides/checkout-api-v2/industry-data/applications-online-platforms.es.md new file mode 100644 index 0000000000..caee972792 --- /dev/null +++ b/guides/checkout-api-v2/industry-data/applications-online-platforms.es.md @@ -0,0 +1,112 @@ +# Aplicaciones y plataformas online + +Estos son los datos específicos para la industria **aplicaciones y plataformas online** que puedes agregar a tu integración para mejorar la aprobación de los pagos. + +## Campos a enviar + +Agrega toda la información adicional que consideres necesaria. + +### Sobre los ítems + +----[mla, mlm, mlu, mco, mlb, mpe]---- +| Array `items` | Tipo | Descripción | +| --- | --- | --- | +| `id` | String | Código de identificación del ítem. | +| `title` | String | Nombre del ítem. | +| `category_id` | String | Categoría del ítem. | +| `quantity` | Integer | Cantidad de unidades para el ítem. | +| `unit_price` | Float | Precio unitario asignado al ítem. Puede ser entero o con decimales. | +------------ + +----[mlc]---- +| Array `items` | Tipo | Descripción | +| --- | --- | --- | +| `id` | String | Código de identificación del ítem. | +| `title` | String | Nombre del ítem. | +| `category_id` | String | Categoría del ítem. | +| `quantity` | Integer | Cantidad de unidades para el ítem. | +| `unit_price` | Float | Precio unitario asignado al ítem. Debe ser un número entero. | +------------ + +### Sobre el comprador + +| Object `payer` | Tipo | Descripción | +| --- | --- | --- | +| `first_name` | String | Nombre del comprador. | +| `last_name` | String | Apellido del comprador. | +| `identification` | Object | Datos de identificación del comprador. | +| `type` | String | Tipo de identificación. Se encuentra dentro del objeto `identification`. | +| `number` | String | Número de identificación. Se encuentra dentro del objeto `identification`. | +| `phone` | Object | Teléfono del comprador. | +| `area_code` | Integer | Código de área del comprador. Se encuentra dentro del objeto `phone`. | +| `number` | Integer | Número de teléfono del comprador. Se encuentra dentro del objeto `phone`. | +| `address` | Object | Datos del domicilio del comprador. | +| `zip_code` | String | Código postal del comprador. Se encuentra dentro del objeto `address`. | +| `street_name` | String | Nombre de calle del domicilio del comprador. Se encuentra dentro del objeto `address`. | +| `street_number` | Integer | Número de calle del domicilio del comprador. Se encuentra dentro del objeto `address`. | +| `authentication_type` | Enum | Tipo de autenticación. Pueden ser "Gmail", "Facebook", "Web Nativa" u "Otro". | +| `registration_date` | Date | Fecha de registro del comprador en el sitio. | +| `is_prime_user` | Boolean | Indica si el usuario es premium. Coloca `true` si lo es o `false` si no lo es. | +| `is_first_purchase_online` | Boolean | Indica si es la primera compra del cliente. Coloca `true` si lo es o `false` si no lo es. | +| `last_purchase` | Date | Fecha de la última compra en el sitio. | + +```curl +curl --location 'https://api.mercadopago.com/v1/payments' \ +--header 'Content-Type: application/json' \ +--header 'X-Idempotency-Key: {{uuid}}' \ +--header 'Authorization: Bearer ACCESS_TOKEN' \ +--header 'X-Meli-Session-Id: {{device_id}} \ +--data-raw '{ + "transaction_amount": 150.00, + "installments": 1, + "statement_descriptor": "LOJA 123", + "capture": true, + "binary_mode": false, + "sponsor_id": null, + "application_fee": null, + "payment_method_id": "debvisa", + "token": "{{card_token_id}}", + "external_reference": "Pedido01", + "description": "PEDIDO NOVO", + "notification_url": "{{notification_url}}", + "metadata": { + "order_number": "order_01" + }, + "payer": { + "email": "test_user_123456789@testuser.com", + "identification": { + "type": "CPF", + "number": "12345678909" + } + }, + "additional_info": { + "items": [ + { + "id": "1234", + "title": "Serviço", + "category_id": "games", + "quantity": 1, + "unit_price": 150 + } + ], + "payer": { + "first_name": "Nome", + "last_name": "Sobrenome", + "is_prime_user": "1", + "is_first_purchase_online": "1", + "last_purchase": "2019-10-25T19:30:00.000-03:00", + "phone": { + "area_code": "11", + "number": "987654321" + }, + "address": { + "zip_code": "206233-2002", + "street_name": "Av. das Nações Unidas", + "street_number": "230032" + }, + "authentication_type": "Facebook", + "registration_date": "2020-08-06T09:25:04.000-03:00" + } + } +}' +``` \ No newline at end of file diff --git a/guides/checkout-api-v2/industry-data/applications-online-platforms.pt.md b/guides/checkout-api-v2/industry-data/applications-online-platforms.pt.md new file mode 100644 index 0000000000..1d667754b0 --- /dev/null +++ b/guides/checkout-api-v2/industry-data/applications-online-platforms.pt.md @@ -0,0 +1,112 @@ +# Aplicativos e plataformas online + +Estes são os dados específicos para a indústria de **aplicativos e plataformas online** que podem ser adicionados à sua integração para melhorar a aprovação dos pagamentos. + +## Campos para enviar + +Adicione qualquer informação extra que considerar necessária. + +### Sobre itens + +----[mla, mlm, mlu, mco, mlb, mpe]---- +| Array `items` | Tipo | Descrição | +| --- | --- | --- | +| `id` | String | Código de identificação do item. | +| `title` | String | Nome do item. | +| `category_id` | String | Categoria do item. | +| `quantity` | Integer | Quantidade de unidades do item. | +| `unit_price` | Float | Preço unitário atribuído ao item. Pode ser um valor inteiro ou em casas decimais. | +------------ + +----[mlc]---- +| Array `items` | Tipo | Descrição | +| --- | --- | --- | +| `id` | String | Código de identificação do item. | +| `title` | String | Nome do item. | +| `category_id` | String | Categoria do item. | +| `quantity` | Integer | Quantidade de unidades do item. | +| `unit_price` | Float | Preço unitário atribuído ao item. Deve ser um valor inteiro. | +------------ + +### Sobre o comprador + +| Object `payer` | Tipo | Descrição | +| --- | --- | --- | +| `first_name` | String | Nome do comprador. | +| `last_name` | String | Sobrenome do comprador. | +| `identification` | Object | Dados de identificação do comprador. | +| `type` | String | Tipo de identificação. Está dentro do objeto `identification`. | +| `number` | String | Número de identificação. Está dentro do objeto `identification`. | +| `phone` | Object | Telefone do comprador. | +| `area_code` | Integer | Código de área do comprador. Está dentro do objeto `phone`. | +| `number` | Integer | Número de telefone do comprador. Está dentro do objeto `phone`. | +| `address` | Object | Dados do endereço do comprador. | +| `zip_code` | String | Código postal do comprador. Está dentro do objeto `address`. | +| `street_name` | String | Nome da rua do endereço do comprador. Está dentro do objeto `address`. | +| `street_number` | Integer | Número da rua do endereço do comprador. Está dentro do objeto `address`. | +| `authentication_type` | Enum | Tipo de autenticação. Pode ser "Gmail", "Facebook", "Web Nativa" ou "Outro". | +| `registration_date` | Date | Data de registro do comprador no site. | +| `is_prime_user` | Boolean | Indica se o usuário é *premium*. Caso seja, use `true` e, caso não seja, use `false`. | +| `is_first_purchase_online` | Boolean | Indica se é a primeira compra do cliente. Caso seja, use `true` e, caso não seja, use `false`. | +| `last_purchase` | Date | Data da última compra no site. | + +```curl +curl --location 'https://api.mercadopago.com/v1/payments' \ +--header 'Content-Type: application/json' \ +--header 'X-Idempotency-Key: {{uuid}}' \ +--header 'Authorization: Bearer ACCESS_TOKEN' \ +--header 'X-Meli-Session-Id: {{device_id}} \ +--data-raw '{ + "transaction_amount": 150.00, + "installments": 1, + "statement_descriptor": "LOJA 123", + "capture": true, + "binary_mode": false, + "sponsor_id": null, + "application_fee": null, + "payment_method_id": "debvisa", + "token": "{{card_token_id}}", + "external_reference": "Pedido01", + "description": "PEDIDO NOVO", + "notification_url": "{{notification_url}}", + "metadata": { + "order_number": "order_01" + }, + "payer": { + "email": "test_user_123456789@testuser.com", + "identification": { + "type": "CPF", + "number": "12345678909" + } + }, + "additional_info": { + "items": [ + { + "id": "1234", + "title": "Serviço", + "category_id": "games", + "quantity": 1, + "unit_price": 150 + } + ], + "payer": { + "first_name": "Nome", + "last_name": "Sobrenome", + "is_prime_user": "1", + "is_first_purchase_online": "1", + "last_purchase": "2019-10-25T19:30:00.000-03:00", + "phone": { + "area_code": "11", + "number": "987654321" + }, + "address": { + "zip_code": "206233-2002", + "street_name": "Av. das Nações Unidas", + "street_number": "230032" + }, + "authentication_type": "Facebook", + "registration_date": "2020-08-06T09:25:04.000-03:00" + } + } +}' +``` \ No newline at end of file diff --git a/guides/checkout-api-v2/industry-data/automobiles-and-nautical.en.md b/guides/checkout-api-v2/industry-data/automobiles-and-nautical.en.md new file mode 100644 index 0000000000..5accb091f7 --- /dev/null +++ b/guides/checkout-api-v2/industry-data/automobiles-and-nautical.en.md @@ -0,0 +1,140 @@ +# Automobiles and nautical + +These are the specific data for the **automobiles and nautical** industry that you can add to your integration to improve payment approval. + +## Fields to send + +Add any additional information that you consider necessary. + +### About items + +----[mla, mlm, mlu, mco, mlb, mpe]---- +| Array `items` | Type | Description | +| --- | --- | --- | +| `id` | String | Item identification code. | +| `title` | String | Item name. | +| `description` | String | Item description. | +| `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. | +------------ + +----[mlc]---- +| Array `items` | Type | Description | +| --- | --- | --- | +| `id` | String | Item identification code. | +| `title` | String | Item name. | +| `description` | String | Item description. | +| `category_id` | String | Item category. | +| `quantity` | Integer | Quantity of units for the item. | +| `unit_price` | Float | Unit price assigned to the item. It must be an integer. | +------------ + +### About the buyer + +| 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". | +| `registration_date` | Date | Buyer's registration date on the site. | +| `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. | + +### About shipments + +| Object `shipment` | Type | Description | +| --- | --- | --- | +| `receiver_address` | Object | Shipping address data. | +| `zip_code` | String | Postal code for the shipment. | +| `state_name` | String | Province to which the order is shipped. | +| `city_name` | String | City to which the order is shipped. | +| `street_number` | Integer | Street number of the shipment. | +| `floor` | String | Apartment floor information for delivery. | +| `apartment` | String | Apartament information for delivery. | +| `local_pickup` | Boolean | If the shipment is picked up at the branch, use `true`, and if not, use `false`.| + +```curl +curl --location 'https://api.mercadopago.com/v1/payments' \ +--header 'Content-Type: application/json' \ +--header 'X-Idempotency-Key: {{uuid}}' \ +--header 'Authorization: Bearer ACCESS_TOKEN' \ +--header 'X-Meli-Session-Id: {{device_id}} \ +--data-raw '{ + "transaction_amount": 15000.00, + "installments": 1, + "statement_descriptor": "LOJA 123", + "capture": true, + "binary_mode": false, + "sponsor_id": null, + "application_fee": null, + "payment_method_id": "debvisa", + "token": "{{card_token_id}}", + "external_reference": "Pedido01", + "description": "PEDIDO NOVO", + "notification_url": "{{notification_url}}", + "metadata": { + "order_number": "order_01" + }, + "payer": { + "email": "test_user_123456789@testuser.com", + "identification": { + "type": "CPF", + "number": "12345678909" + } + }, + "additional_info": { + "items": [ + { + "id": "1234", + "title": "Serviço", + "description": "Descrição de serviço", + "category_id": "truck", + "quantity": 1, + "unit_price": 15000 + } + ], + "payer": { + "first_name": "Nome", + "last_name": "Sobrenome", + "is_first_purchase_online": "1", + "last_purchase": "2019-10-25T19:30:00.000-03:00", + "phone": { + "area_code": "11", + "number": "987654321" + }, + "address": { + "zip_code": "206233-2002", + "street_name": "Av. das Nações Unidas", + "street_number": "230032" + }, + "authentication_type": "Facebook", + "registration_date": "2020-08-06T09:25:04.000-03:00" + }, + "shipments": { + "local_pickup": true, + "receiver_address": { + "zip_code": "306233-2003", + "street_name": "Av. das Nações Unidas", + "street_number": "330033", + "floor": "5", + "apartment": "502", + "state_name": "DF", + "city_name": "Bogota" + } + } + } +}' +``` + + diff --git a/guides/checkout-api-v2/industry-data/automobiles-and-nautical.es.md b/guides/checkout-api-v2/industry-data/automobiles-and-nautical.es.md new file mode 100644 index 0000000000..965b7aa9bc --- /dev/null +++ b/guides/checkout-api-v2/industry-data/automobiles-and-nautical.es.md @@ -0,0 +1,140 @@ +# Automóviles y náuticas + +Estos son los datos específicos para la industria **automóviles y náuticas** que puedes agregar a tu integración para mejorar la aprobación de los pagos. + +## Campos a enviar + +Agrega toda la información adicional que consideres necesaria. + +### Sobre los ítems + +----[mla, mlm, mlu, mco, mlb, mpe]---- +| Array `items` | Tipo | Descripción | +| --- | --- | --- | +| `id` | String | Código de identificación del ítem. | +| `title` | String | Nombre del ítem. | +| `description` | String | Descripción del ítem. | +| `category_id` | String | Categoría del ítem. | +| `quantity` | Integer | Cantidad de unidades para el ítem. | +| `unit_price` | Float | Precio unitario asignado al ítem. Puede ser entero o con decimales. | +------------ + +----[mlc]---- +| Array `items` | Tipo | Descripción | +| --- | --- | --- | +| `id` | String | Código de identificación del ítem. | +| `title` | String | Nombre del ítem. | +| `description` | String | Descripción del ítem. | +| `category_id` | String | Categoría del ítem. | +| `quantity` | Integer | Cantidad de unidades para el ítem. | +| `unit_price` | Float | Precio unitario asignado al ítem. Debe ser un número entero. | +------------ + +### Sobre el comprador + +| Object `payer` | Tipo | Descripción | +| --- | --- | --- | +| `first_name` | String | Nombre del comprador. | +| `last_name` | String | Apellido del comprador. | +| `identification` | Object | Datos de identificación del comprador. | +| `type` | String | Tipo de identificación. Se encuentra dentro del objeto `identification`. | +| `number` | String | Número de identificación. Se encuentra dentro del objeto `identification`. | +| `phone` | Object | Teléfono del comprador. | +| `area_code` | Integer | Código de área del comprador. Se encuentra dentro del objeto `phone`. | +| `number` | Integer | Número de teléfono del comprador. Se encuentra dentro del objeto `phone`. | +| `address` | Object | Datos del domicilio del comprador. | +| `zip_code` | String | Código postal del comprador. Se encuentra dentro del objeto `address`. | +| `street_name` | String | Nombre de calle del domicilio del comprador. Se encuentra dentro del objeto `address`. | +| `street_number` | Integer | Número de calle del domicilio del comprador. Se encuentra dentro del objeto `address`. | +| `authentication_type` | Enum | Tipo de autenticación. Pueden ser "Gmail", "Facebook", "Web Nativa" u "Otro". | +| `registration_date` | Date | Fecha de registro del comprador en el sitio. | +| `is_first_purchase_online` | Boolean | Indica si es la primera compra del cliente. Coloca `true` si lo es o `false` si no lo es. | +| `last_purchase` | Date | Fecha de la última compra en el sitio. | + +### Sobre envíos + +| Object `shipment` | Tipo | Descripción | +| --- | --- | --- | +| `receiver_address` | Object | Datos de dirección del envío. | +| `zip_code` | String | Código postal para el envío. | +| `state_name` | String | Provincia hacia donde se envía el pedido. | +| `city_name` | String | Ciudad hacia donde se envía el pedido. | +| `street_number` | Integer | Número de calle del envío. | +| `floor` | String | Información del piso del departamento para la entrega. | +| `apartment` | String | Información del departamento para la entrega. | +| `local_pickup` | Boolean | Si el envío se retira en sucursal, coloca `true`, y si no se retira, coloca `false`.| + +```curl +curl --location 'https://api.mercadopago.com/v1/payments' \ +--header 'Content-Type: application/json' \ +--header 'X-Idempotency-Key: {{uuid}}' \ +--header 'Authorization: Bearer ACCESS_TOKEN' \ +--header 'X-Meli-Session-Id: {{device_id}} \ +--data-raw '{ + "transaction_amount": 15000.00, + "installments": 1, + "statement_descriptor": "LOJA 123", + "capture": true, + "binary_mode": false, + "sponsor_id": null, + "application_fee": null, + "payment_method_id": "debvisa", + "token": "{{card_token_id}}", + "external_reference": "Pedido01", + "description": "PEDIDO NOVO", + "notification_url": "{{notification_url}}", + "metadata": { + "order_number": "order_01" + }, + "payer": { + "email": "test_user_123456789@testuser.com", + "identification": { + "type": "CPF", + "number": "12345678909" + } + }, + "additional_info": { + "items": [ + { + "id": "1234", + "title": "Serviço", + "description": "Descrição de serviço", + "category_id": "truck", + "quantity": 1, + "unit_price": 15000 + } + ], + "payer": { + "first_name": "Nome", + "last_name": "Sobrenome", + "is_first_purchase_online": "1", + "last_purchase": "2019-10-25T19:30:00.000-03:00", + "phone": { + "area_code": "11", + "number": "987654321" + }, + "address": { + "zip_code": "206233-2002", + "street_name": "Av. das Nações Unidas", + "street_number": "230032" + }, + "authentication_type": "Facebook", + "registration_date": "2020-08-06T09:25:04.000-03:00" + }, + "shipments": { + "local_pickup": true, + "receiver_address": { + "zip_code": "306233-2003", + "street_name": "Av. das Nações Unidas", + "street_number": "330033", + "floor": "5", + "apartment": "502", + "state_name": "DF", + "city_name": "Bogota" + } + } + } +}' +``` + + diff --git a/guides/checkout-api-v2/industry-data/automobiles-and-nautical.pt.md b/guides/checkout-api-v2/industry-data/automobiles-and-nautical.pt.md new file mode 100644 index 0000000000..eb888063f4 --- /dev/null +++ b/guides/checkout-api-v2/industry-data/automobiles-and-nautical.pt.md @@ -0,0 +1,138 @@ +# Automóveis e náutica + +Estes são os dados específicos para a indústria de **automóveis e náutica** que podem ser adicionados à sua integração para melhorar a aprovação dos pagamentos. + +## Campos para enviar + +Adicione qualquer informação extra que considerar necessária. + +### Sobre itens + +----[mla, mlm, mlu, mco, mlb, mpe]---- +| Array `items` | Tipo | Descrição | +| --- | --- | --- | +| `id` | String | Código de identificação do item. | +| `title` | String | Nome do item. | +| `description` | String | Descrição do item. | +| `category_id` | String | Categoria do item. | +| `quantity` | Integer | Quantidade de unidades do item. | +| `unit_price` | Float | Preço unitário atribuído ao item. Pode ser um valor inteiro ou em casas decimais. | +------------ + +----[mlc]---- +| Array `items` | Tipo | Descrição | +| --- | --- | --- | +| `id` | String | Código de identificação do item. | +| `title` | String | Nome do item. | +| `description` | String | Descrição. | +| `category_id` | String | Categoria do item. | +| `quantity` | Integer | Quantidade de unidades do item. | +| `unit_price` | Float | Preço unitário atribuído ao item. Deve ser um valor inteiro. | +------------ + +### Sobre o comprador + +| Object `payer` | Tipo | Descrição | +| --- | --- | --- | +| `first_name` | String | Nome do comprador. | +| `last_name` | String | Sobrenome do comprador. | +| `identification` | Object | Dados de identificação do comprador. | +| `type` | String | Tipo de identificação. Está dentro do objeto `identification`. | +| `number` | String | Número de identificação. Está dentro do objeto `identification`. | +| `phone` | Object | Telefone do comprador. | +| `area_code` | Integer | Código de área do comprador. Está dentro do objeto `phone`. | +| `number` | Integer | Número de telefone do comprador. Está dentro do objeto `phone`. | +| `address` | Object | Dados do endereço do comprador. | +| `zip_code` | String | Código postal do comprador. Está dentro do objeto `address`. | +| `street_name` | String | Nome da rua do endereço do comprador. Está dentro do objeto `address`. | +| `street_number` | Integer | Número da rua do endereço do comprador. Está dentro do objeto `address`. | +| `authentication_type` | Enum | Tipo de autenticação. Pode ser "Gmail", "Facebook", "Web Nativa" ou "Outro". | +| `registration_date` | Date | Data de registro do comprador no site. | +| `is_first_purchase_online` | Boolean | Indica se é a primeira compra do cliente. Caso seja, use `true` e, caso não seja, use `false`. | +| `last_purchase` | Date | Data da última compra no site. | + +### Sobre envios + +| Object `shipment` | Tipo | Descrição | +| --- | --- | --- | +| `receiver_address` | Object | Dados do endereço da entrega. | +| `zip_code` | String | Código postal para a entrega. | +| `state_name` | String | Estado para onde o pedido é enviado. | +| `city_name` | String | Cidade para onde o pedido é enviado. | +| `street_number` | Integer | Número da rua da entrega. | +| `floor` | String | Informações do andar do apartamento para a entrega. | +| `apartment` | String | Informações do apartamento para a entrega. | +| `local_pickup` | Boolean | Se retira na agência, use `true` e, caso não retira, use `false`. | + +```curl +curl --location 'https://api.mercadopago.com/v1/payments' \ +--header 'Content-Type: application/json' \ +--header 'X-Idempotency-Key: {{uuid}}' \ +--header 'Authorization: Bearer ACCESS_TOKEN' \ +--header 'X-Meli-Session-Id: {{device_id}} \ +--data-raw '{ + "transaction_amount": 15000.00, + "installments": 1, + "statement_descriptor": "LOJA 123", + "capture": true, + "binary_mode": false, + "sponsor_id": null, + "application_fee": null, + "payment_method_id": "debvisa", + "token": "{{card_token_id}}", + "external_reference": "Pedido01", + "description": "PEDIDO NOVO", + "notification_url": "{{notification_url}}", + "metadata": { + "order_number": "order_01" + }, + "payer": { + "email": "test_user_123456789@testuser.com", + "identification": { + "type": "CPF", + "number": "12345678909" + } + }, + "additional_info": { + "items": [ + { + "id": "1234", + "title": "Serviço", + "description": "Descrição de serviço", + "category_id": "truck", + "quantity": 1, + "unit_price": 15000 + } + ], + "payer": { + "first_name": "Nome", + "last_name": "Sobrenome", + "is_first_purchase_online": "1", + "last_purchase": "2019-10-25T19:30:00.000-03:00", + "phone": { + "area_code": "11", + "number": "987654321" + }, + "address": { + "zip_code": "206233-2002", + "street_name": "Av. das Nações Unidas", + "street_number": "230032" + }, + "authentication_type": "Facebook", + "registration_date": "2020-08-06T09:25:04.000-03:00" + }, + "shipments": { + "local_pickup": true, + "receiver_address": { + "zip_code": "306233-2003", + "street_name": "Av. das Nações Unidas", + "street_number": "330033", + "floor": "5", + "apartment": "502", + "state_name": "DF", + "city_name": "Bogota" + } + } + } +}' +``` \ No newline at end of file diff --git a/guides/checkout-api-v2/industry-data/direct-sale.en.md b/guides/checkout-api-v2/industry-data/direct-sale.en.md new file mode 100644 index 0000000000..ed1f64c085 --- /dev/null +++ b/guides/checkout-api-v2/industry-data/direct-sale.en.md @@ -0,0 +1,143 @@ +# Direct sale + +These are the specific data for the **direct sale** industry that you can add to your integration to improve payment approval. + +## Fields to send + +Add any additional information that you consider necessary. + +### About items + +----[mla, mlm, mlu, mco, mlb, mpe]---- +| Array `items` | Type | Description | +| --- | --- | --- | +| `id` | String | Item identification code. | +| `title` | String | Item name. | +| `type` | String | Item type. | +| `description` | String | Item description. | +| `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. | +------------ + +----[mlc]---- +| Array `items` | Type | Description | +| --- | --- | --- | +| `id` | String | Item identification code. | +| `title` | String | Item name. | +| `type` | String | Item type. | +| `description` | String | Item description. | +| `category_id` | String | Item category. | +| `quantity` | Integer | Quantity of units for the item. | +| `unit_price` | Float | Unit price assigned to the item. It must be an integer. | +------------ + +### About the buyer + +| 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". | +| `registration_date` | 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. | + +### About shipments + +| Object `shipment` | Type | Description | +| --- | --- | --- | +| `receiver_address` | Object | Shipping address data. | +| `zip_code` | String | Postal code for the shipment. | +| `state_name` | String | Province to which the order is shipped. | +| `city_name` | String | City to which the order is shipped. | +| `street_number` | Integer | Street number of the shipment. | +| `floor` | String | Apartament floor information for delivery. | +| `apartment` | String | Apartament information for delivery. | +| `local_pickup` | Boolean | If the shipment is withdrawn at branch, use `1`. If not, use `0`. | + +```curl +curl --location 'https://api.mercadopago.com/v1/payments' \ +--header 'Content-Type: application/json' \ +--header 'X-Idempotency-Key: {{uuid}}' \ +--header 'Authorization: Bearer ACCESS_TOKEN' \ +--header 'X-Meli-Session-Id: {{device_id}} \ +--data-raw '{ + "transaction_amount": 1500.00, + "installments": 1, + "statement_descriptor": "LOJA 123", + "capture": true, + "binary_mode": false, + "sponsor_id": null, + "application_fee": null, + "payment_method_id": "debvisa", + "token": "{{card_token_id}}", + "external_reference": "Pedido01", + "description": "PEDIDO NOVO", + "notification_url": "{{notification_url}}", + "metadata": { + "order_number": "order_01" + }, + "payer": { + "email": "test_user_123456789@testuser.com", + "identification": { + "type": "CPF", + "number": "12345678909" + } + }, + "additional_info": { + "items": [ + { + "id": "1234", + "title": "Direct sale", + "description": "Gold ring", + "category_id": "jewelry", + "quantity": 1, + "unit_price": 1500 + } + ], + "payer": { + "first_name": "Nome", + "last_name": "Sobrenome", + "is_prime_user": "1", + "is_first_purchase_online": "1", + "last_purchase": "2019-10-25T19:30:00.000-03:00", + "phone": { + "area_code": "11", + "number": "987654321" + }, + "address": { + "zip_code": "206233-2002", + "street_name": "Av. das Nações Unidas", + "street_number": "230032" + }, + "authentication_type": "Facebook", + "registration_date": "2020-08-06T09:25:04.000-03:00" + }, + "shipments": { + "local_pickup": "1", + "receiver_address": { + "zip_code": "306233-2003", + "street_name": "Av. das Nações Unidas", + "street_number": "3003", + "floor": "5", + "apartment": "502", + "state_name": "DF", + "city_name": "Bogota" + } + } + } +}' +``` + diff --git a/guides/checkout-api-v2/industry-data/direct-sale.es.md b/guides/checkout-api-v2/industry-data/direct-sale.es.md new file mode 100644 index 0000000000..21618111b8 --- /dev/null +++ b/guides/checkout-api-v2/industry-data/direct-sale.es.md @@ -0,0 +1,143 @@ +# Venta directa + +Estos son los datos específicos para la industria **venta directa** que puedes agregar a tu integración para mejorar la aprobación de los pagos. + +## Campos a enviar + +Agrega toda la información adicional que consideres necesaria. + +### Sobre los ítems + +----[mla, mlm, mlu, mco, mlb, mpe]---- +| Array `items` | Tipo | Descripción | +| --- | --- | --- | +| `id` | String | Código de identificación del ítem. | +| `title` | String | Nombre del ítem. | +| `type` | String | Tipo de ítem. | +| `description` | String | Descripción del ítem. | +| `category_id` | String | Categoría del ítem. | +| `quantity` | Integer | Cantidad de unidades para el ítem. | +| `unit_price` | Float | Precio unitario asignado al ítem. Puede ser entero o con decimales. | +------------ + +----[mlc]---- +| Array `items` | Tipo | Descripción | +| --- | --- | --- | +| `id` | String | Código de identificación del ítem. | +| `title` | String | Nombre del ítem. | +| `type` | String | Tipo de ítem. | +| `description` | String | Descripción del ítem. | +| `category_id` | String | Categoría del ítem. | +| `quantity` | Integer | Cantidad de unidades para el ítem. | +| `unit_price` | Float | Precio unitario asignado al ítem. Debe ser un número entero. | +------------ + +### Sobre el comprador + +| Object `payer` | Tipo | Descripción | +| --- | --- | --- | +| `first_name` | String | Nombre del comprador. | +| `last_name` | String | Apellido del comprador. | +| `identification` | Object | Datos de identificación del comprador. | +| `type` | String | Tipo de identificación. Se encuentra dentro del objeto `identification`. | +| `number` | String | Número de identificación. Se encuentra dentro del objeto `identification`. | +| `phone` | Object | Teléfono del comprador. | +| `area_code` | Integer | Código de área del comprador. Se encuentra dentro del objeto `phone`. | +| `number` | Integer | Número de teléfono del comprador. Se encuentra dentro del objeto `phone`. | +| `address` | Object | Datos del domicilio del comprador. | +| `zip_code` | String | Código postal del comprador. Se encuentra dentro del objeto `address`. | +| `street_name` | String | Nombre de calle del domicilio del comprador. Se encuentra dentro del objeto `address`. | +| `street_number` | Integer | Número de calle del domicilio del comprador. Se encuentra dentro del objeto `address`. | +| `authentication_type` | Enum | Tipo de autenticación. Pueden ser "Gmail", "Facebook", "Web Nativa" u "Otro". | +| `registration_date` | Date | Fecha de registro del comprador en el sitio. | +| `is_prime_user` | Boolean | Indica si el usuario es premium. Coloca `true` si lo es o `false` si no lo es. | +| `is_first_purchase_online` | Boolean | Indica si es la primera compra del cliente. Coloca `true` si lo es o `false` si no lo es. | +| `last_purchase` | Date | Fecha de la última compra en el sitio. | + +### Sobre envíos + +| Object `shipment` | Tipo | Descripción | +| --- | --- | --- | +| `receiver_address` | Object | Datos de dirección del envío. | +| `zip_code` | String | Código postal para el envío. | +| `state_name` | String | Provincia hacia donde se envía el pedido. | +| `city_name` | String | Ciudad hacia donde se envía el pedido. | +| `street_number` | Integer | Número de calle del envío. | +| `floor` | String | Información del piso del departamento para la entrega. | +| `apartment` | String | Información del departamento para la entrega. | +| `local_pickup` | Boolean | Si se retira en la sucursal, coloca `1`. De lo contrario, coloca `0`. | + +```curl +curl --location 'https://api.mercadopago.com/v1/payments' \ +--header 'Content-Type: application/json' \ +--header 'X-Idempotency-Key: {{uuid}}' \ +--header 'Authorization: Bearer ACCESS_TOKEN' \ +--header 'X-Meli-Session-Id: {{device_id}} \ +--data-raw '{ + "transaction_amount": 1500.00, + "installments": 1, + "statement_descriptor": "LOJA 123", + "capture": true, + "binary_mode": false, + "sponsor_id": null, + "application_fee": null, + "payment_method_id": "debvisa", + "token": "{{card_token_id}}", + "external_reference": "Pedido01", + "description": "PEDIDO NOVO", + "notification_url": "{{notification_url}}", + "metadata": { + "order_number": "order_01" + }, + "payer": { + "email": "test_user_123456789@testuser.com", + "identification": { + "type": "CPF", + "number": "12345678909" + } + }, + "additional_info": { + "items": [ + { + "id": "1234", + "title": "Direct sale", + "description": "Gold ring", + "category_id": "jewelry", + "quantity": 1, + "unit_price": 1500 + } + ], + "payer": { + "first_name": "Nome", + "last_name": "Sobrenome", + "is_prime_user": "1", + "is_first_purchase_online": "1", + "last_purchase": "2019-10-25T19:30:00.000-03:00", + "phone": { + "area_code": "11", + "number": "987654321" + }, + "address": { + "zip_code": "206233-2002", + "street_name": "Av. das Nações Unidas", + "street_number": "230032" + }, + "authentication_type": "Facebook", + "registration_date": "2020-08-06T09:25:04.000-03:00" + }, + "shipments": { + "local_pickup": "1", + "receiver_address": { + "zip_code": "306233-2003", + "street_name": "Av. das Nações Unidas", + "street_number": "3003", + "floor": "5", + "apartment": "502", + "state_name": "DF", + "city_name": "Bogota" + } + } + } +}' +``` + diff --git a/guides/checkout-api-v2/industry-data/direct-sale.pt.md b/guides/checkout-api-v2/industry-data/direct-sale.pt.md new file mode 100644 index 0000000000..28c5d9a250 --- /dev/null +++ b/guides/checkout-api-v2/industry-data/direct-sale.pt.md @@ -0,0 +1,143 @@ +# Venda direta + +Estes são os dados específicos para a indústria de **venda direta** que podem ser adicionados à sua integração para melhorar a aprovação dos pagamentos. + +## Campos para enviar + +Adicione qualquer informação extra que considerar necessária. + +### Sobre itens + +----[mla, mlm, mlu, mco, mlb, mpe]---- +| Array `items` | Tipo | Descrição| +| --- | --- | --- | +| `id` | String | Código de identificação do item. | +| `title` | String | Nome do item. | +| `type` | String | Tipo de item. | +| `description` | String | Descrição do item. | +| `category_id` | String | Categoria do item. | +| `quantity` | Integer | Quantidade de unidades do item. | +| `unit_price` | Float | Preço unitário atribuído ao item. Pode ser um valor inteiro ou em casas decimais. | +------------ + +----[mlc]---- +| Array `items` | Tipo | Descrição| +| --- | --- | --- | +| `id` | String | Código de identificação do item. | +| `title` | String | Nome do item. | +| `type` | String | Tipo de item. | +| `description` | String | Descrição do item. | +| `category_id` | String | Categoria do item. | +| `quantity` | Integer | Quantidade de unidades do item. | +| `unit_price` | Float | Preço unitário atribuído ao item. Deve ser um valor inteiro. | +------------ + +### Sobre o comprador + +| Object `payer` | Tipo | Descrição | +| --- | --- | --- | +| `first_name` | String | Nome do comprador. | +| `last_name` | String | Sobrenome do comprador. | +| `identification` | Object | Dados de identificação do comprador. | +| `type` | String | Tipo de identificação. Está dentro do objeto `identification`. | +| `number` | String | Número de identificação. Está dentro do objeto `identification`. | +| `phone` | Object | Telefone do comprador. | +| `area_code` | Integer | Código de área do comprador. Está dentro do objeto `phone`. | +| `number` | Integer | Número de telefone do comprador. Está dentro do objeto `phone`. | +| `address` | Object | Dados do endereço do comprador. | +| `zip_code` | String | Código postal do comprador. Está dentro do objeto `address`. | +| `street_name` | String | Nome da rua do endereço do comprador. Está dentro do objeto `address`. | +| `street_number` | Integer | Número da rua do endereço do comprador. Está dentro do objeto `address`. | +| `authentication_type` | Enum | Tipo de autenticação. Pode ser "Gmail", "Facebook", "Web Nativa" ou "Outro". | +| `registration_date` | Date | Data de registro do comprador no site. | +| `is_prime_user` | Boolean | Indica se o usuário é *premium*. Caso seja, use `true` e, caso não seja, use `false`. | +| `is_first_purchase_online` | Boolean | Indica se é a primeira compra do cliente. Caso seja, use `true` e, caso não seja, use `false`. | +| `last_purchase` | Date | Data da última compra no site. | + +### Sobre envios + +| Object `shipment` | Tipo | Descrição | +| --- | --- | --- | +| `receiver_address` | Object | Dados do endereço da entrega. | +| `zip_code` | String | Código postal para a entrega. | +| `state_name` | String | Estado para onde o pedido é enviado. | +| `city_name` | String | Cidade para onde o pedido é enviado. | +| `street_number` | Integer | Número da rua da entrega. | +| `floor` | String | Informações do andar do apartamento para a entrega. | +| `apartment` | String | Informações do apartamento para a entrega. | +| `local_pickup` | Boolean | Caso seja retirada na loja, use `1` e, caso não seja, use `0`. | + +```curl +curl --location 'https://api.mercadopago.com/v1/payments' \ +--header 'Content-Type: application/json' \ +--header 'X-Idempotency-Key: {{uuid}}' \ +--header 'Authorization: Bearer ACCESS_TOKEN' \ +--header 'X-Meli-Session-Id: {{device_id}} \ +--data-raw '{ + "transaction_amount": 1500.00, + "installments": 1, + "statement_descriptor": "LOJA 123", + "capture": true, + "binary_mode": false, + "sponsor_id": null, + "application_fee": null, + "payment_method_id": "debvisa", + "token": "{{card_token_id}}", + "external_reference": "Pedido01", + "description": "PEDIDO NOVO", + "notification_url": "{{notification_url}}", + "metadata": { + "order_number": "order_01" + }, + "payer": { + "email": "test_user_123456789@testuser.com", + "identification": { + "type": "CPF", + "number": "12345678909" + } + }, + "additional_info": { + "items": [ + { + "id": "1234", + "title": "Direct sale", + "description": "Gold ring", + "category_id": "jewelry", + "quantity": 1, + "unit_price": 1500 + } + ], + "payer": { + "first_name": "Nome", + "last_name": "Sobrenome", + "is_prime_user": "1", + "is_first_purchase_online": "1", + "last_purchase": "2019-10-25T19:30:00.000-03:00", + "phone": { + "area_code": "11", + "number": "987654321" + }, + "address": { + "zip_code": "206233-2002", + "street_name": "Av. das Nações Unidas", + "street_number": "230032" + }, + "authentication_type": "Facebook", + "registration_date": "2020-08-06T09:25:04.000-03:00" + }, + "shipments": { + "local_pickup": "1", + "receiver_address": { + "zip_code": "306233-2003", + "street_name": "Av. das Nações Unidas", + "street_number": "3003", + "floor": "5", + "apartment": "502", + "state_name": "DF", + "city_name": "Bogota" + } + } + } +}' +``` + diff --git a/guides/checkout-api-v2/industry-data/electro.en.md b/guides/checkout-api-v2/industry-data/electro.en.md new file mode 100644 index 0000000000..504dc5a820 --- /dev/null +++ b/guides/checkout-api-v2/industry-data/electro.en.md @@ -0,0 +1,143 @@ +# Electro + +These are the specific data for the **electro** industry that you can add to your integration to improve payment approval. + +## Fields to send + +Add any additional information that you consider necessary. + +### About items + +----[mla, mlm, mlu, mco, mlb, mpe]---- +| Array `items` | Type | Description | +| --- | --- | --- | +| `id` | String | Item identification code. | +| `title` | String | Item name. | +| `description` | String | Item description. | +| `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. | +| `warranty` | Boolean | If the product has a guarantee, use `true`. I it does not, use `false`. | +------------ + +----[mlc]---- +| Array `items` | Type | Description | +| --- | --- | --- | +| `id` | String | Item identification code. | +| `title` | String | Item name. | +| `description` | String | Item description. | +| `category_id` | String | Item category. | +| `quantity` | Integer | Quantity of units for the item. | +| `unit_price` | Float | Unit price assigned to the item. It must be an integer. | +| `warranty` | Boolean | If the product has a guarantee, use `true`. I it does not, use `false`. | +------------ + +### About the buyer + +| 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". | +| `registration_date` | 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. | + +### About shipments + +| Object `shipment` | Type | Description | +| --- | --- | --- | +| `local_pickup` | Boolean | If the shipment is picked up at the branch, use `true`, and if not, use `false`.| +| `receiver_address` | Object | Shipping address data. | +| `zip_code` | String | Postal code for the shipment. | +| `state_name` | String | Province to which the order is shipped. | +| `city_name` | String | City to which the order is shipped. | +| `street_number` | Integer | Street number of the shipment. | +| `express_shipment` | Boolean | Indicates if the shipment is express. `true` if it is, `false` if it is not. | + +```curl +curl --location 'https://api.mercadopago.com/v1/payments' \ +--header 'Content-Type: application/json' \ +--header 'X-Idempotency-Key: {{uuid}}' \ +--header 'Authorization: Bearer ACCESS_TOKEN' \ +--header 'X-Meli-Session-Id: {{device_id}}' \ +--data-raw '{ + "transaction_amount": 150.00, + "installments": 1, + "statement_descriptor": "LOJA 123", + "capture": true, + "binary_mode": false, + "sponsor_id": null, + "application_fee": null, + "payment_method_id": "debvisa", + "token": "{{card_token_id}}", + "external_reference": "Pedido01", + "description": "PEDIDO NOVO", + "notification_url": "{{notification_url}}", + "metadata": { + "order_number": "order_01" + }, + "payer": { + "email": "test_user_123456789@testuser.com", + "identification": { + "type": "CPF", + "number": "12345678909" + } + }, + "additional_info": { + "items": [ + { + "id": "1234", + "title": "Product", + "description": "Product description", + "warranty": true, + "category_id": "kitchen", + "quantity": 1, + "unit_price": 150 + } + ], + "payer": { + "first_name": "Name", + "last_name": "Surname", + "is_prime_user": "1", + "is_first_purchase_online": "1", + "last_purchase": "2019-10-25T19:30:00.000-03:00", + "phone": { + "area_code": "11", + "number": "987654321" + }, + "address": { + "zip_code": "206233-2002", + "street_name": "Av. das Nações Unidas", + "street_number": "230032" + }, + "authentication_type": "Facebook", + "registration_date": "2020-08-06T09:25:04.000-03:00" + }, + "shipments": { + "express_shipment": "1", + "local_pickup": "1", + "receiver_address": { + "zip_code": "306233-2003", + "street_name": "Av. das Nações Unidas", + "street_number": "3003", + "floor": "5", + "apartment": "502", + "state_name":"SP", + "city_name":"Osasco" + } + } + } +}' +``` diff --git a/guides/checkout-api-v2/industry-data/electro.es.md b/guides/checkout-api-v2/industry-data/electro.es.md new file mode 100644 index 0000000000..8f59db7f85 --- /dev/null +++ b/guides/checkout-api-v2/industry-data/electro.es.md @@ -0,0 +1,143 @@ +# Electro + +Estos son los datos específicos para la industria **electro** que puedes agregar a tu integración para mejorar la aprobación de los pagos. + +## Campos a enviar + +Agrega toda la información adicional que consideres necesaria. + +### Sobre los ítems + +----[mla, mlm, mlu, mco, mlb, mpe]---- +| Array `items` | Tipo | Descripción | +| --- | --- | --- | +| `id` | String | Código de identificación del ítem. | +| `title` | String | Nombre del ítem. | +| `description` | String | Descripción del ítem. | +| `category_id` | String | Categoría del ítem. | +| `quantity` | Integer | Cantidad de unidades para el ítem. | +| `unit_price` | Float | Precio unitario asignado al ítem. Puede ser entero o con decimales. | +| `warranty` | Boolean | Si el producto tiene garantía, coloca `true`. Si no la tiene, coloca `false`. | +------------ + +----[mlc]---- +| Array `items` | Tipo | Descripción | +| --- | --- | --- | +| `id` | String | Código de identificación del ítem. | +| `title` | String | Nombre del ítem. | +| `description` | String | Descripción del ítem. | +| `category_id` | String | Categoría del ítem. | +| `quantity` | Integer | Cantidad de unidades para el ítem. | +| `unit_price` | Float | Precio unitario asignado al ítem. Debe ser un número entero. | +| `warranty` | Boolean | Si el producto tiene garantía, coloca `true`. Si no la tiene, coloca `false`. | +------------ + +### Sobre el comprador + +| Object `payer` | Tipo | Descripción | +| --- | --- | --- | +| `first_name` | String | Nombre del comprador. | +| `last_name` | String | Apellido del comprador. | +| `identification` | Object | Datos de identificación del comprador. | +| `type` | String | Tipo de identificación. Se encuentra dentro del objeto `identification`. | +| `number` | String | Número de identificación. Se encuentra dentro del objeto `identification`. | +| `phone` | Object | Teléfono del comprador. | +| `area_code` | Integer | Código de área del comprador. Se encuentra dentro del objeto `phone`. | +| `number` | Integer | Número de teléfono del comprador. Se encuentra dentro del objeto `phone`. | +| `address` | Object | Datos del domicilio del comprador. | +| `zip_code` | String | Código postal del comprador. Se encuentra dentro del objeto `address`. | +| `street_name` | String | Nombre de calle del domicilio del comprador. Se encuentra dentro del objeto `address`. | +| `street_number` | Integer | Número de calle del domicilio del comprador. Se encuentra dentro del objeto `address`. | +| `authentication_type` | Enum | Tipo de autenticación. Pueden ser "Gmail", "Facebook", "Web Nativa" u "Otro". | +| `registration_date` | Date | Fecha de registro del comprador en el sitio. | +| `is_prime_user` | Boolean | Indica si el usuario es premium. Coloca `true` si lo es o `false` si no lo es. | +| `is_first_purchase_online` | Boolean | Indica si es la primera compra del cliente. Coloca `true` si lo es o `false` si no lo es. | +| `last_purchase` | Date | Fecha de la última compra en el sitio. | + +### Sobre envíos + +| Object `shipment` | Tipo | Descripción | +| --- | --- | --- | +| `local_pickup` | Boolean | Si el envío se retira en sucursal, coloca `true`, y si no se retira, coloca `false`.| +| `receiver_address` | Object | Datos de dirección del envío. | +| `zip_code` | String | Código postal para el envío. | +| `state_name` | String | Provincia hacia donde se envía el pedido. | +| `city_name` | String | Ciudad hacia donde se envía el pedido. | +| `street_number` | Integer | Número de calle del envío. | +| `express_shipment` | Boolean | Indica si el envío es rápido. `true` si lo es, `false` si no lo es. | + +```curl +curl --location 'https://api.mercadopago.com/v1/payments' \ +--header 'Content-Type: application/json' \ +--header 'X-Idempotency-Key: {{uuid}}' \ +--header 'Authorization: Bearer ACCESS_TOKEN' \ +--header 'X-Meli-Session-Id: {{device_id}}' \ +--data-raw '{ + "transaction_amount": 150.00, + "installments": 1, + "statement_descriptor": "LOJA 123", + "capture": true, + "binary_mode": false, + "sponsor_id": null, + "application_fee": null, + "payment_method_id": "debvisa", + "token": "{{card_token_id}}", + "external_reference": "Pedido01", + "description": "PEDIDO NOVO", + "notification_url": "{{notification_url}}", + "metadata": { + "order_number": "order_01" + }, + "payer": { + "email": "test_user_123456789@testuser.com", + "identification": { + "type": "CPF", + "number": "12345678909" + } + }, + "additional_info": { + "items": [ + { + "id": "1234", + "title": "Producto", + "description": "Descripción del producto", + "warranty": true, + "category_id": "kitchen", + "quantity": 1, + "unit_price": 150 + } + ], + "payer": { + "first_name": "Nombre", + "last_name": "Apellido", + "is_prime_user": "1", + "is_first_purchase_online": "1", + "last_purchase": "2019-10-25T19:30:00.000-03:00", + "phone": { + "area_code": "11", + "number": "987654321" + }, + "address": { + "zip_code": "206233-2002", + "street_name": "Av. das Nações Unidas", + "street_number": "230032" + }, + "authentication_type": "Facebook", + "registration_date": "2020-08-06T09:25:04.000-03:00" + }, + "shipments": { + "express_shipment": "1", + "local_pickup": "1", + "receiver_address": { + "zip_code": "306233-2003", + "street_name": "Av. das Nações Unidas", + "street_number": "3003", + "floor": "5", + "apartment": "502", + "state_name":"SP", + "city_name":"Osasco" + } + } + } +}' +``` diff --git a/guides/checkout-api-v2/industry-data/electro.pt.md b/guides/checkout-api-v2/industry-data/electro.pt.md new file mode 100644 index 0000000000..85b8d6b232 --- /dev/null +++ b/guides/checkout-api-v2/industry-data/electro.pt.md @@ -0,0 +1,143 @@ +# Eletro + +Estes são os dados específicos para a indústria de **eletro** que podem ser adicionados à sua integração para melhorar a aprovação dos pagamentos. + +## Campos para enviar + +Adicione qualquer informação extra que considerar necessária. + +### Sobre itens + +----[mla, mlm, mlu, mco, mlb, mpe]---- +| Array `items` | Tipo | Descrição | +| --- | --- | --- | +| `id` | String | Código de identificação do item. | +| `title` | String | Nome do item. | +| `description` | String | Descrição do item. | +| `category_id` | String | Categoria do item. | +| `quantity` | Integer | Quantidade de unidades do item. | +| `unit_price` | Float | Preço unitário atribuído ao item. Pode ser um valor inteiro ou em casas decimais. | +| `warranty` | Boolean | Caso o produto tenha garantia, use `true` e, caso não tenha, use `false`. | +------------ + +----[mlc]---- +| Array `items` | Tipo | Descrição | +| --- | --- | --- | +| `id` | String | Código de identificação do item. | +| `title` | String | Nome do item. | +| `description` | String | Descrição do item. | +| `category_id` | String | Categoria do item. | +| `quantity` | Integer | Quantidade de unidades do item. | +| `unit_price` | Float | Preço unitário atribuído ao item. Deve ser um valor inteiro. | +| `warranty` | Boolean | Caso o produto tenha garantia, use `true` e, caso não tenha, use `false`. | +------------ + +### Sobre o comprador + +| Object `payer` | Tipo | Descrição | +| --- | --- | --- | +| `first_name` | String | Nome do comprador. | +| `last_name` | String | Sobrenome do comprador. | +| `identification` | Object | Dados de identificação do comprador. | +| `type` | String | Tipo de identificação. Está dentro do objeto `identification`. | +| `number` | String | Número de identificação. Está dentro do objeto `identification`. | +| `phone` | Object | Telefone do comprador. | +| `area_code` | Integer | Código de área do comprador. Está dentro do objeto `phone`. | +| `number` | Integer | Número de telefone do comprador. Está dentro do objeto `phone`. | +| `address` | Object | Dados do endereço do comprador. | +| `zip_code` | String | Código postal do comprador. Está dentro do objeto `address`. | +| `street_name` | String | Nome da rua do endereço do comprador. Está dentro do objeto `address`. | +| `street_number` | Integer | Número da rua do endereço do comprador. Está dentro do objeto `address`. | +| `authentication_type` | Enum | Tipo de autenticação. Pode ser "Gmail", "Facebook", "Web Nativa" ou "Outro". | +| `registration_date` | Date | Data de registro do comprador no site. | +| `is_prime_user` | Boolean | Indica se o usuário é *premium*. Caso seja, use `true` e, caso não seja, use `false`. | +| `is_first_purchase_online` | Boolean | Indica se é a primeira compra do cliente. Caso seja, use `true` e, caso não seja, use `false`. | +| `last_purchase` | Date | Data da última compra no site. | + +### Sobre envios + +| Object `shipment` | Tipo | Descrição | +| --- | --- | --- | +| `local_pickup` | Boolean | Se retira na agência, use `true` e, caso não retira, use `false`. | +| `receiver_address` | Object | Dados do endereço da entrega. | +| `zip_code` | String | Código postal para a entrega. | +| `state_name` | String | Estado para onde o pedido é enviado. | +| `city_name` | String | Cidade para onde o pedido é enviado. | +| `street_number` | Integer | Número da rua da entrega. | +| `express_shipment` | Boolean | Indica se a entrega é expressa. Caso seja, use `true` e, caso não seja, use `false`. | + +```curl +curl --location 'https://api.mercadopago.com/v1/payments' \ +--header 'Content-Type: application/json' \ +--header 'X-Idempotency-Key: {{uuid}}' \ +--header 'Authorization: Bearer ACCESS_TOKEN' \ +--header 'X-Meli-Session-Id: {{device_id}}' \ +--data-raw '{ + "transaction_amount": 150.00, + "installments": 1, + "statement_descriptor": "LOJA 123", + "capture": true, + "binary_mode": false, + "sponsor_id": null, + "application_fee": null, + "payment_method_id": "debvisa", + "token": "{{card_token_id}}", + "external_reference": "Pedido01", + "description": "PEDIDO NOVO", + "notification_url": "{{notification_url}}", + "metadata": { + "order_number": "order_01" + }, + "payer": { + "email": "test_user_123456789@testuser.com", + "identification": { + "type": "CPF", + "number": "12345678909" + } + }, + "additional_info": { + "items": [ + { + "id": "1234", + "title": "Produto", + "description": "Descrição do produto", + "warranty": true, + "category_id": "kitchen", + "quantity": 1, + "unit_price": 150 + } + ], + "payer": { + "first_name": "Nome", + "last_name": "Sobrenome", + "is_prime_user": "1", + "is_first_purchase_online": "1", + "last_purchase": "2019-10-25T19:30:00.000-03:00", + "phone": { + "area_code": "11", + "number": "987654321" + }, + "address": { + "zip_code": "206233-2002", + "street_name": "Av. das Nações Unidas", + "street_number": "230032" + }, + "authentication_type": "Facebook", + "registration_date": "2020-08-06T09:25:04.000-03:00" + }, + "shipments": { + "express_shipment": "1", + "local_pickup": "1", + "receiver_address": { + "zip_code": "306233-2003", + "street_name": "Av. das Nações Unidas", + "street_number": "3003", + "floor": "5", + "apartment": "502", + "state_name":"SP", + "city_name":"Osasco" + } + } + } +}' +``` diff --git a/guides/checkout-api-v2/industry-data/gambling.en.md b/guides/checkout-api-v2/industry-data/gambling.en.md new file mode 100644 index 0000000000..6a8f1c7a93 --- /dev/null +++ b/guides/checkout-api-v2/industry-data/gambling.en.md @@ -0,0 +1,115 @@ +# Gambling + +These are the specific data for the **gambling** industry that you can add to your integration to improve payment approval. + +## Fields to send + +Add any additional information that you consider necessary. + +### About items + +----[mla, mlm, mlu, mco, mlb, mpe]---- +| 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. | +------------ + +----[mlc]---- +| 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 must be an integer. | +------------ + +### About the buyer + +| 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". | +| `registration_date` | 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. | + +```curl +curl --location 'https://api.mercadopago.com/v1/payments' \ +--header 'Content-Type: application/json' \ +--header 'X-Idempotency-Key: {{uuid}}' \ +--header 'Authorization: Bearer ACCESS_TOKEN' \ +--header 'X-Meli-Session-Id: {{device_id}} \ +--data-raw '{ + "transaction_amount": 150.00, + "installments": 1, + "statement_descriptor": "LOJA 123", + "capture": true, + "binary_mode": false, + "sponsor_id": null, + "application_fee": null, + "payment_method_id": "debvisa", + "token": "{{card_token_id}}", + "external_reference": "Ticket01", + "description": "Lottery", + "notification_url": "{{notification_url}}", + "metadata": { + "order_number": "order_01" + }, + "payer": { + "email": "test_user_123456789@testuser.com", + "identification": { + "type": "CPF", + "number": "12345678909" + } + }, + "additional_info": { + "items": [ + { + "id": "1234", + "title": "Serviço", + "warranty": true, + "category_id": "lottery", + "quantity": 1, + "unit_price": 150 + } + ], + "payer": { + "first_name": "Nome", + "last_name": "Sobrenome", + "is_prime_user": "1", + "is_first_purchase_online": "1", + "last_purchase": "2019-10-25T19:30:00.000-03:00", + "phone": { + "area_code": "11", + "number": "987654321" + }, + "address": { + "zip_code": "206233-2002", + "street_name": "Av. das Nações Unidas", + "street_number": "230032" + }, + "authentication_type": "Facebook", + "registration_date": "2020-08-06T09:25:04.000-03:00" + } + } +}' +``` \ No newline at end of file diff --git a/guides/checkout-api-v2/industry-data/gambling.es.md b/guides/checkout-api-v2/industry-data/gambling.es.md new file mode 100644 index 0000000000..a915f256d2 --- /dev/null +++ b/guides/checkout-api-v2/industry-data/gambling.es.md @@ -0,0 +1,115 @@ +# Gambling + +Estos son los datos específicos para la industria **gambling** que puedes agregar a tu integración para mejorar la aprobación de los pagos. + +## Campos a enviar + +Agrega toda la información adicional que consideres necesaria. + +### Sobre los ítems + +----[mla, mlm, mlu, mco, mlb, mpe]---- +| Array `items` | Tipo |Descripción | +|---|---|---| +| `id` | String | Código de identificación del ítem. | +| `title` | String | Nombre del ítem. | +| `warranty` | Boolean | `true` si lo es, `false` si no lo es. | +| `category_id` | String | Categoría del ítem. | +| `quantity` | Integer | Cantidad de unidades para el ítem. | +| `unit_price` | Float | Precio unitario asignado al ítem. Puede ser entero o con decimales. | +------------ + +----[mlc]---- +| Array `items` | Tipo |Descripción | +|---|---|---| +| `id` | String | Código de identificación del ítem. | +| `title` | String | Nombre del ítem. | +| `warranty` | Boolean | `true` si lo es, `false` si no lo es. | +| `category_id` | String | Categoría del ítem. | +| `quantity` | Integer | Cantidad de unidades para el ítem. | +| `unit_price` | Float | Precio unitario asignado al ítem. Debe ser un número entero. | +------------ + +### Sobre el comprador + +| Object `payer` | Tipo | Descripción | +| --- | --- | --- | +| `first_name` | String | Nombre del comprador. | +| `last_name` | String | Apellido del comprador. | +| `identification` | Object | Datos de identificación del comprador. | +| `type` | String | Tipo de identificación. Se encuentra dentro del objeto `identification`. | +| `number` | String | Número de identificación. Se encuentra dentro del objeto `identification`. | +| `phone` | Object | Teléfono del comprador. | +| `area_code` | Integer | Código de área del comprador. Se encuentra dentro del objeto `phone`. | +| `number` | Integer | Número de teléfono del comprador. Se encuentra dentro del objeto `phone`. | +| `address` | Object | Datos del domicilio del comprador. | +| `zip_code` | String | Código postal del comprador. Se encuentra dentro del objeto `address`. | +| `street_name` | String | Nombre de calle del domicilio del comprador. Se encuentra dentro del objeto `address`. | +| `street_number` | Integer | Número de calle del domicilio del comprador. Se encuentra dentro del objeto `address`. | +| `authentication_type` | Enum | Tipo de autenticación. Pueden ser "Gmail", "Facebook", "Web Nativa" u "Otro". | +| `registration_date` | Date | Fecha de registro del comprador en el sitio. | +| `is_prime_user` | Boolean | Indica si el usuario es premium. Coloca `true` si lo es o `false` si no lo es. | +| `is_first_purchase_online` | Boolean | Indica si es la primera compra del cliente. Coloca `true` si lo es o `false` si no lo es. | +| `last_purchase` | Date | Fecha de la última compra en el sitio. | + +```curl +curl --location 'https://api.mercadopago.com/v1/payments' \ +--header 'Content-Type: application/json' \ +--header 'X-Idempotency-Key: {{uuid}}' \ +--header 'Authorization: Bearer ACCESS_TOKEN' \ +--header 'X-Meli-Session-Id: {{device_id}} \ +--data-raw '{ + "transaction_amount": 150.00, + "installments": 1, + "statement_descriptor": "LOJA 123", + "capture": true, + "binary_mode": false, + "sponsor_id": null, + "application_fee": null, + "payment_method_id": "debvisa", + "token": "{{card_token_id}}", + "external_reference": "Ticket01", + "description": "Lottery", + "notification_url": "{{notification_url}}", + "metadata": { + "order_number": "order_01" + }, + "payer": { + "email": "test_user_123456789@testuser.com", + "identification": { + "type": "CPF", + "number": "12345678909" + } + }, + "additional_info": { + "items": [ + { + "id": "1234", + "title": "Serviço", + "warranty": true, + "category_id": "lottery", + "quantity": 1, + "unit_price": 150 + } + ], + "payer": { + "first_name": "Nome", + "last_name": "Sobrenome", + "is_prime_user": "1", + "is_first_purchase_online": "1", + "last_purchase": "2019-10-25T19:30:00.000-03:00", + "phone": { + "area_code": "11", + "number": "987654321" + }, + "address": { + "zip_code": "206233-2002", + "street_name": "Av. das Nações Unidas", + "street_number": "230032" + }, + "authentication_type": "Facebook", + "registration_date": "2020-08-06T09:25:04.000-03:00" + } + } +}' +``` \ No newline at end of file diff --git a/guides/checkout-api-v2/industry-data/gambling.pt.md b/guides/checkout-api-v2/industry-data/gambling.pt.md new file mode 100644 index 0000000000..1b0c6609a9 --- /dev/null +++ b/guides/checkout-api-v2/industry-data/gambling.pt.md @@ -0,0 +1,115 @@ +# Gambling + +Estes são os dados específicos para a indústria de **gambling** que podem ser adicionados à sua integração para melhorar a aprovação dos pagamentos. + +## Campos para enviar + +Adicione qualquer informação extra que considerar necessária. + +### Sobre itens + +----[mla, mlm, mlu, mco, mlb, mpe]---- +| Array `items` | Tipo | Descrição | +| --- | --- | --- | +| `id` | String | Código de identificação do item. | +| `title` | String | Nome do item. | +| `warranty` | Boolean | `true` se é, `false` se não é. | +| `category_id` | String | Categoria do item. | +| `quantity` | Integer | Quantidade de unidades do item. | +| `unit_price` | Float | Preço unitário atribuído ao item. Pode ser um valor inteiro ou em casas decimais. | +------------ + +----[mlc]---- +| Array `items` | Tipo | Descrição | +| --- | --- | --- | +| `id` | String | Código de identificação do item. | +| `title` | String | Nome do item. | +| `warranty` | Boolean | `true` se é, `false` se não é. | +| `category_id` | String | Categoria do item. | +| `quantity` | Integer | Quantidade de unidades do item. | +| `unit_price` | Float | Preço unitário atribuído ao item. Deve ser um valor inteiro. | +------------ + +### Sobre o comprador + +| Object `payer` | Tipo | Descrição | +| --- | --- | --- | +| `first_name` | String | Nome do comprador. | +| `last_name` | String | Sobrenome do comprador. | +| `identification` | Object | Dados de identificação do comprador. | +| `type` | String | Tipo de identificação. Está dentro do objeto `identification`. | +| `number` | String | Número de identificação. Está dentro do objeto `identification`. | +| `phone` | Object | Telefone do comprador. | +| `area_code` | Integer | Código de área do comprador. Está dentro do objeto `phone`. | +| `number` | Integer | Número de telefone do comprador. Está dentro do objeto `phone`. | +| `address` | Object | Dados do endereço do comprador. | +| `zip_code` | String | Código postal do comprador. Está dentro do objeto `address`. | +| `street_name` | String | Nome da rua do endereço do comprador. Está dentro do objeto `address`. | +| `street_number` | Integer | Número da rua do endereço do comprador. Está dentro do objeto `address`. | +| `authentication_type` | Enum | Tipo de autenticação. Pode ser "Gmail", "Facebook", "Web Nativa" ou "Outro". | +| `registration_date` | Date | Data de registro do comprador no site. | +| `is_prime_user` | Boolean | Indica se o usuário é *premium*. Caso seja, use `true` e, caso não seja, use `false`. | +| `is_first_purchase_online` | Boolean | Indica se é a primeira compra do cliente. Caso seja, use `true` e, caso não seja, use `false`. | +| `last_purchase` | Date | Data da última compra no site. | + +```curl +curl --location 'https://api.mercadopago.com/v1/payments' \ +--header 'Content-Type: application/json' \ +--header 'X-Idempotency-Key: {{uuid}}' \ +--header 'Authorization: Bearer ACCESS_TOKEN' \ +--header 'X-Meli-Session-Id: {{device_id}} \ +--data-raw '{ + "transaction_amount": 150.00, + "installments": 1, + "statement_descriptor": "LOJA 123", + "capture": true, + "binary_mode": false, + "sponsor_id": null, + "application_fee": null, + "payment_method_id": "debvisa", + "token": "{{card_token_id}}", + "external_reference": "Ticket01", + "description": "Lottery", + "notification_url": "{{notification_url}}", + "metadata": { + "order_number": "order_01" + }, + "payer": { + "email": "test_user_123456789@testuser.com", + "identification": { + "type": "CPF", + "number": "12345678909" + } + }, + "additional_info": { + "items": [ + { + "id": "1234", + "title": "Serviço", + "warranty": true, + "category_id": "lottery", + "quantity": 1, + "unit_price": 150 + } + ], + "payer": { + "first_name": "Nome", + "last_name": "Sobrenome", + "is_prime_user": "1", + "is_first_purchase_online": "1", + "last_purchase": "2019-10-25T19:30:00.000-03:00", + "phone": { + "area_code": "11", + "number": "987654321" + }, + "address": { + "zip_code": "206233-2002", + "street_name": "Av. das Nações Unidas", + "street_number": "230032" + }, + "authentication_type": "Facebook", + "registration_date": "2020-08-06T09:25:04.000-03:00" + } + } +}' +``` \ No newline at end of file diff --git a/guides/checkout-api-v2/industry-data/goverments-public-services.en.md b/guides/checkout-api-v2/industry-data/goverments-public-services.en.md new file mode 100644 index 0000000000..1a121406be --- /dev/null +++ b/guides/checkout-api-v2/industry-data/goverments-public-services.en.md @@ -0,0 +1,118 @@ +# Government and public services + +These are the specific data for the **government and public services** industry that you can add to your integration to improve payment approval. + +## Fields to send + +Add any additional information that you consider necessary. + +### About items + +----[mla, mlm, mlu, mco, mlb, mpe]---- +| Array `items` | Type | Description | +| --- | --- | --- | +| `id` | String | Item identification code. | +| `title` | String | Item name. | +| `description` | String | Item description. | +| `category_id` | String | 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. | +| `event_date` | Date | Event date. | +------------ + +----[mlc]---- +| Array `items` | Type | Description | +| --- | --- | --- | +| `id` | String | Item identification code. | +| `title` | String | Item name. | +| `description` | String | Item description. | +| `category_id` | String | Category. | +| `quantity` | Integer | Quantity of units for the item. | +| `unit_price` | Float | Unit price assigned to the item. It must be an integer. | +| `event_date` | Date | Event date. | +------------ + +### About the buyer + +| 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". | +| `registration_date` | 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. | + +```curl +curl --location 'https://api.mercadopago.com/v1/payments' \ +--header 'Content-Type: application/json' \ +--header 'X-Idempotency-Key: {{uuid}}' \ +--header 'Authorization: Bearer ACCESS_TOKEN' \ +--header 'X-Meli-Session-Id: {{device_id}} \ +--data-raw '{ + "transaction_amount": 150.00, + "installments": 1, + "statement_descriptor": "LOJA 123", + "capture": true, + "binary_mode": false, + "sponsor_id": null, + "application_fee": null, + "payment_method_id": "debvisa", + "token": "{{card_token_id}}", + "external_reference": "Pedido01", + "description": "PEDIDO NOVO", + "notification_url": "{{notification_url}}", + "metadata": { + "order_number": "order_01" + }, + "payer": { + "email": "test_user_123456789@testuser.com", + "identification": { + "type": "CPF", + "number": "12345678909" + } + }, + "additional_info": { + "items": [ + { + "id": "1234", + "title": "Serviço", + "event_date": "2019-12-25T19:30:00.000-03:00", + "description": "Descrição de serviço", + "category_id": "service", + "quantity": 1, + "unit_price": 150 + } + ], + "payer": { + "first_name": "Nome", + "last_name": "Sobrenome", + "is_prime_user": "1", + "is_first_purchase_online": "1", + "last_purchase": "2019-10-25T19:30:00.000-03:00", + "phone": { + "area_code": "11", + "number": "987654321" + }, + "address": { + "zip_code": "206233-2002", + "street_name": "Av. das Nações Unidas", + "street_number": "230032" + }, + "authentication_type": "Facebook", + "registration_date": "2020-08-06T09:25:04.000-03:00" + } + } +}' +``` \ No newline at end of file diff --git a/guides/checkout-api-v2/industry-data/goverments-public-services.es.md b/guides/checkout-api-v2/industry-data/goverments-public-services.es.md new file mode 100644 index 0000000000..e325358011 --- /dev/null +++ b/guides/checkout-api-v2/industry-data/goverments-public-services.es.md @@ -0,0 +1,118 @@ +# Gobierno y servicios públicos + +Estos son los datos específicos para la industria **gobierno y servicios públicos** que puedes agregar a tu integración para mejorar la aprobación de los pagos. + +## Campos a enviar + +Agrega toda la información adicional que consideres necesaria. + +### Sobre los ítems + +----[mla, mlm, mlu, mco, mlb, mpe]---- +| Array `items` | Tipo | Descripción | +| --- | --- | --- | +| `id` | String | Código de identificación del ítem. | +| `title` | String | Nombre del ítem. | +| `description` | String | Descripción del ítem. | +| `category_id` | String | Categoría del ítem. | +| `quantity` | Integer | Cantidad de unidades para el ítem. | +| `unit_price` | Float | Precio unitario asignado al ítem. Puede ser entero o con decimales. | +| `event_date` | Date | Fecha del evento. | +------------ + +----[mlc]---- +| Array `items` | Tipo | Descripción | +| --- | --- | --- | +| `id` | String | Código de identificación del ítem. | +| `title` | String | Nombre del ítem. | +| `description` | String | Descripción del ítem. | +| `category_id` | String | Categoría del ítem. | +| `quantity` | Integer | Cantidad de unidades para el ítem. | +| `unit_price` | Float | Precio unitario asignado al ítem. Debe ser un número entero. | +| `event_date` | Date | Fecha del evento. | +------------ + +### Sobre el comprador + +| Object `payer` | Tipo | Descripción | +| --- | --- | --- | +| `first_name` | String | Nombre del comprador. | +| `last_name` | String | Apellido del comprador. | +| `identification` | Object | Datos de identificación del comprador. | +| `type` | String | Tipo de identificación. Se encuentra dentro del objeto `identification`. | +| `number` | String | Número de identificación. Se encuentra dentro del objeto `identification`. | +| `phone` | Object | Teléfono del comprador. | +| `area_code` | Integer | Código de área del comprador. Se encuentra dentro del objeto `phone`. | +| `number` | Integer | Número de teléfono del comprador. Se encuentra dentro del objeto `phone`. | +| `address` | Object | Datos del domicilio del comprador. | +| `zip_code` | String | Código postal del comprador. Se encuentra dentro del objeto `address`. | +| `street_name` | String | Nombre de calle del domicilio del comprador. Se encuentra dentro del objeto `address`. | +| `street_number` | Integer | Número de calle del domicilio del comprador. Se encuentra dentro del objeto `address`. | +| `authentication_type` | Enum | Tipo de autenticación. Pueden ser "Gmail", "Facebook", "Web Nativa" u "Otro". | +| `registration_date` | Date | Fecha de registro del comprador en el sitio. | +| `is_prime_user` | Boolean | Indica si el usuario es premium. Coloca `true` si lo es o `false` si no lo es. | +| `is_first_purchase_online` | Boolean | Indica si es la primera compra del cliente. Coloca `true` si lo es o `false` si no lo es. | +| `last_purchase` | Date | Fecha de la última compra en el sitio. | + +```curl +curl --location 'https://api.mercadopago.com/v1/payments' \ +--header 'Content-Type: application/json' \ +--header 'X-Idempotency-Key: {{uuid}}' \ +--header 'Authorization: Bearer ACCESS_TOKEN' \ +--header 'X-Meli-Session-Id: {{device_id}} \ +--data-raw '{ + "transaction_amount": 150.00, + "installments": 1, + "statement_descriptor": "LOJA 123", + "capture": true, + "binary_mode": false, + "sponsor_id": null, + "application_fee": null, + "payment_method_id": "debvisa", + "token": "{{card_token_id}}", + "external_reference": "Pedido01", + "description": "PEDIDO NOVO", + "notification_url": "{{notification_url}}", + "metadata": { + "order_number": "order_01" + }, + "payer": { + "email": "test_user_123456789@testuser.com", + "identification": { + "type": "CPF", + "number": "12345678909" + } + }, + "additional_info": { + "items": [ + { + "id": "1234", + "title": "Serviço", + "event_date": "2019-12-25T19:30:00.000-03:00", + "description": "Descrição de serviço", + "category_id": "service", + "quantity": 1, + "unit_price": 150 + } + ], + "payer": { + "first_name": "Nome", + "last_name": "Sobrenome", + "is_prime_user": "1", + "is_first_purchase_online": "1", + "last_purchase": "2019-10-25T19:30:00.000-03:00", + "phone": { + "area_code": "11", + "number": "987654321" + }, + "address": { + "zip_code": "206233-2002", + "street_name": "Av. das Nações Unidas", + "street_number": "230032" + }, + "authentication_type": "Facebook", + "registration_date": "2020-08-06T09:25:04.000-03:00" + } + } +}' +``` \ No newline at end of file diff --git a/guides/checkout-api-v2/industry-data/goverments-public-services.pt.md b/guides/checkout-api-v2/industry-data/goverments-public-services.pt.md new file mode 100644 index 0000000000..a800213fe8 --- /dev/null +++ b/guides/checkout-api-v2/industry-data/goverments-public-services.pt.md @@ -0,0 +1,118 @@ +# Serviços governamentais e públicos + +Estes são os dados específicos para a indústria de **serviços governamentais e públicos** que podem ser adicionados à sua integração para melhorar a aprovação dos pagamentos. + +## Campos para enviar + +Adicione qualquer informação extra que considerar necessária. + +### Sobre itens + +----[mla, mlm, mlu, mco, mlb, mpe]---- +| Array `items` | Tipo | Descrição | +| --- | --- | --- | +| `id` | String | Código de identificação do item. | +| `title` | String | Nome do item. | +| `description` | String | Descrição do item. | +| `category_id` | String | Categoria do item. | +| `quantity` | Integer | Quantidade de unidades do item. | +| `unit_price` | Float | Preço unitário atribuído ao item. Pode ser um valor inteiro ou em casas decimais. | +| `event_date` | Date | Data do evento. | +------------ + +----[mlc]---- +| Array `items` | Tipo | Descrição | +| --- | --- | --- | +| `id` | String | Código de identificação do item. | +| `title` | String | Nome do item. | +| `description` | String | Descrição do item. | +| `category_id` | String | Categoria do item. | +| `quantity` | Integer | Quantidade de unidades do item. | +| `unit_price` | Float | Preço unitário atribuído ao item. Deve ser um valor inteiro. | +| `event_date` | Date | Data do evento. | +------------ + +### Sobre o comprador + +| Object `payer` | Tipo | Descrição | +| --- | --- | --- | +| `first_name` | String | Nome do comprador. | +| `last_name` | String | Sobrenome do comprador. | +| `identification` | Object | Dados de identificação do comprador. | +| `type` | String | Tipo de identificação. Está dentro do objeto `identification`. | +| `number` | String | Número de identificação. Está dentro do objeto `identification`. | +| `phone` | Object | Telefone do comprador. | +| `area_code` | Integer | Código de área do comprador. Está dentro do objeto `phone`. | +| `number` | Integer | Número de telefone do comprador. Está dentro do objeto `phone`. | +| `address` | Object | Dados do endereço do comprador. | +| `zip_code` | String | Código postal do comprador. Está dentro do objeto `address`. | +| `street_name` | String | Nome da rua do endereço do comprador. Está dentro do objeto `address`. | +| `street_number` | Integer | Número da rua do endereço do comprador. Está dentro do objeto `address`. | +| `authentication_type` | Enum | Tipo de autenticação. Pode ser "Gmail", "Facebook", "Web Nativa" ou "Outro". | +| `registration_date` | Date | Data de registro do comprador no site. | +| `is_prime_user` | Boolean | Indica se o usuário é *premium*. Caso seja, use `true` e, caso não seja, use `false`. | +| `is_first_purchase_online` | Boolean | Indica se é a primeira compra do cliente. Caso seja, use `true` e, caso não seja, use `false`. | +| `last_purchase` | Date | Data da última compra no site. | + +```curl +curl --location 'https://api.mercadopago.com/v1/payments' \ +--header 'Content-Type: application/json' \ +--header 'X-Idempotency-Key: {{uuid}}' \ +--header 'Authorization: Bearer ACCESS_TOKEN' \ +--header 'X-Meli-Session-Id: {{device_id}} \ +--data-raw '{ + "transaction_amount": 150.00, + "installments": 1, + "statement_descriptor": "LOJA 123", + "capture": true, + "binary_mode": false, + "sponsor_id": null, + "application_fee": null, + "payment_method_id": "debvisa", + "token": "{{card_token_id}}", + "external_reference": "Pedido01", + "description": "PEDIDO NOVO", + "notification_url": "{{notification_url}}", + "metadata": { + "order_number": "order_01" + }, + "payer": { + "email": "test_user_123456789@testuser.com", + "identification": { + "type": "CPF", + "number": "12345678909" + } + }, + "additional_info": { + "items": [ + { + "id": "1234", + "title": "Serviço", + "event_date": "2019-12-25T19:30:00.000-03:00", + "description": "Descrição de serviço", + "category_id": "service", + "quantity": 1, + "unit_price": 150 + } + ], + "payer": { + "first_name": "Nome", + "last_name": "Sobrenome", + "is_prime_user": "1", + "is_first_purchase_online": "1", + "last_purchase": "2019-10-25T19:30:00.000-03:00", + "phone": { + "area_code": "11", + "number": "987654321" + }, + "address": { + "zip_code": "206233-2002", + "street_name": "Av. das Nações Unidas", + "street_number": "230032" + }, + "authentication_type": "Facebook", + "registration_date": "2020-08-06T09:25:04.000-03:00" + } + } +}' +``` \ No newline at end of file diff --git a/guides/checkout-api-v2/industry-data/home-and-deco.en.md b/guides/checkout-api-v2/industry-data/home-and-deco.en.md new file mode 100644 index 0000000000..f60a77160c --- /dev/null +++ b/guides/checkout-api-v2/industry-data/home-and-deco.en.md @@ -0,0 +1,141 @@ +# Home & deco + +These are the specific data for the **home & deco** industry that you can add to your integration to improve payment approval. + +## Fields to send + +Add any additional information that you consider necessary. + +### About items + +----[mla, mlm, mlu, mco, mlb, mpe]---- +| Array `items` | Type | Description | +| --- | --- | --- | +| `id` | String | Item identification code. | +| `title` | String | Item name. | +| `description` | String | Item description. | +| `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. | +| `warranty` | Boolean | If the product has a guarantee, use `true`. I it does not, use `false`. | +------------ + +----[mlc]---- +| Array `items` | Type | Description | +| --- | --- | --- | +| `id` | String | Item identification code. | +| `title` | String | Item name. | +| `description` | String | Item description. | +| `category_id` | String | Item category. | +| `quantity` | Integer | Quantity of units for the item. | +| `unit_price` | Float | Unit price assigned to the item. It must be an integer. | +| `warranty` | Boolean | If the product has a guarantee, use `true`. I it does not, use `false`. | +------------ + +### About the buyer + +| 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". | +| `registration_date` | 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. | + +#### About shipments + +| Object `shipment` | Type | Description | +| --- | --- | --- | +| `receiver_address` | Object | Shipping address data. | +| `zip_code` | String | Postal code for the shipment. | +| `state_name` | String | Province to which the order is shipped. | +| `city_name` | String | City to which the order is shipped. | +| `street_number` | Integer | Street number of the shipment. | +| `express_shipment` | Boolean | Indicates if the shipment is express. `true` if it is, `false` if it is not. | + +```curl +curl --location 'https://api.mercadopago.com/v1/payments' \ +--header 'Content-Type: application/json' \ +--header 'X-Idempotency-Key: {{uuid}}' \ +--header 'Authorization: Bearer ACCESS_TOKEN' \ +--header 'X-Meli-Session-Id: {{device_id}} \ +--data-raw '{ + "transaction_amount": 150.00, + "installments": 1, + "statement_descriptor": "LOJA 123", + "capture": true, + "binary_mode": false, + "sponsor_id": null, + "application_fee": null, + "payment_method_id": "debvisa", + "token": "{{card_token_id}}", + "external_reference": "Pedido01", + "description": "PEDIDO NOVO", + "notification_url": "{{notification_url}}", + "metadata": { + "order_number": "order_01" + }, + "payer": { + "email": "test_user_123456789@testuser.com", + "identification": { + "type": "CPF", + "number": "12345678909" + } + }, + "additional_info": { + "items": [ + { + "id": "1234", + "title": "Serviço", + "warranty": true, + "description": "Descrição de serviço", + "category_id": "kitchen", + "quantity": 1, + "unit_price": 150 + } + ], + "payer": { + "first_name": "Nome", + "last_name": "Sobrenome", + "is_prime_user": "1", + "is_first_purchase_online": "1", + "last_purchase": "2019-10-25T19:30:00.000-03:00", + "phone": { + "area_code": "11", + "number": "987654321" + }, + "address": { + "zip_code": "206233-2002", + "street_name": "Av. das Nações Unidas", + "street_number": "3003" + }, + "authentication_type": "Facebook", + "registration_date": "2020-08-06T09:25:04.000-03:00" + }, + "shipments": { + "express_shipment": "1", + "receiver_address": { + "zip_code": "306233-2003", + "street_name": "Av. das Nações Unidas", + "street_number": "3003", + "floor": "5", + "apartment": "502", + "state_name":"SP", + "city_name":"Osasco" + } + } + } +}' +``` \ No newline at end of file diff --git a/guides/checkout-api-v2/industry-data/home-and-deco.es.md b/guides/checkout-api-v2/industry-data/home-and-deco.es.md new file mode 100644 index 0000000000..ac614d4301 --- /dev/null +++ b/guides/checkout-api-v2/industry-data/home-and-deco.es.md @@ -0,0 +1,141 @@ +# Home & deco + +Estos son los datos específicos para la industria **home & deco** que puedes agregar a tu integración para mejorar la aprobación de los pagos. + +## Campos a enviar + +Agrega toda la información adicional que consideres necesaria. + +### Sobre los ítems + +----[mla, mlm, mlu, mco, mlb, mpe]---- +| Array `items` | Tipo | Descripción | +| --- | --- | --- | +| `id` | String | Código de identificación del ítem. | +| `title` | String | Nombre del ítem. | +| `description` | String | Descripción del ítem. | +| `category_id` | String | Categoría del ítem. | +| `quantity` | Integer | Cantidad de unidades para el ítem. | +| `unit_price` | Float | Precio unitario asignado al ítem. Puede ser entero o con decimales. | +| `warranty` | Boolean | Si el producto tiene garantía, coloca `true`. Si no la tiene, coloca `false`. | +------------ + +----[mlc]---- +| Array `items` | Tipo | Descripción | +| --- | --- | --- | +| `id` | String | Código de identificación del ítem. | +| `title` | String | Nombre del ítem. | +| `description` | String | Descripción del ítem. | +| `category_id` | String | Categoría del ítem. | +| `quantity` | Integer | Cantidad de unidades para el ítem. | +| `unit_price` | Float | Precio unitario asignado al ítem. Debe ser un número entero. | +| `warranty` | Boolean | Si el producto tiene garantía, coloca `true`. Si no la tiene, coloca `false`. | +------------ + +### Sobre el comprador + +| Object `payer` | Tipo | Descripción | +| --- | --- | --- | +| `first_name` | String | Nombre del comprador. | +| `last_name` | String | Apellido del comprador. | +| `identification` | Object | Datos de identificación del comprador. | +| `type` | String | Tipo de identificación. Se encuentra dentro del objeto `identification`. | +| `number` | String | Número de identificación. Se encuentra dentro del objeto `identification`. | +| `phone` | Object | Teléfono del comprador. | +| `area_code` | Integer | Código de área del comprador. Se encuentra dentro del objeto `phone`. | +| `number` | Integer | Número de teléfono del comprador. Se encuentra dentro del objeto `phone`. | +| `address` | Object | Datos del domicilio del comprador. | +| `zip_code` | String | Código postal del comprador. Se encuentra dentro del objeto `address`. | +| `street_name` | String | Nombre de calle del domicilio del comprador. Se encuentra dentro del objeto `address`. | +| `street_number` | Integer | Número de calle del domicilio del comprador. Se encuentra dentro del objeto `address`. | +| `authentication_type` | Enum | Tipo de autenticación. Pueden ser "Gmail", "Facebook", "Web Nativa" u "Otro". | +| `registration_date` | Date | Fecha de registro del comprador en el sitio. | +| `is_prime_user` | Boolean | Indica si el usuario es premium. Coloca `true` si lo es o `false` si no lo es. | +| `is_first_purchase_online` | Boolean | Indica si es la primera compra del cliente. Coloca `true` si lo es o `false` si no lo es. | +| `last_purchase` | Date | Fecha de la última compra en el sitio. | + +### Sobre envíos + +| Object `shipment` | Tipo | Descripción | +| --- | --- | --- | +| `receiver_address` | Object | Datos de dirección del envío. | +| `zip_code` | String | Código postal para el envío. | +| `state_name` | String | Provincia hacia donde se envía el pedido. | +| `city_name` | String | Ciudad hacia donde se envía el pedido. | +| `street_number` | Integer | Número de calle del envío. | +| `express_shipment` | Boolean | Indica si el envío es rápido. `true` si lo es, `false` si no lo es. | + +```curl +curl --location 'https://api.mercadopago.com/v1/payments' \ +--header 'Content-Type: application/json' \ +--header 'X-Idempotency-Key: {{uuid}}' \ +--header 'Authorization: Bearer ACCESS_TOKEN' \ +--header 'X-Meli-Session-Id: {{device_id}} \ +--data-raw '{ + "transaction_amount": 150.00, + "installments": 1, + "statement_descriptor": "LOJA 123", + "capture": true, + "binary_mode": false, + "sponsor_id": null, + "application_fee": null, + "payment_method_id": "debvisa", + "token": "{{card_token_id}}", + "external_reference": "Pedido01", + "description": "PEDIDO NOVO", + "notification_url": "{{notification_url}}", + "metadata": { + "order_number": "order_01" + }, + "payer": { + "email": "test_user_123456789@testuser.com", + "identification": { + "type": "CPF", + "number": "12345678909" + } + }, + "additional_info": { + "items": [ + { + "id": "1234", + "title": "Serviço", + "warranty": true, + "description": "Descrição de serviço", + "category_id": "kitchen", + "quantity": 1, + "unit_price": 150 + } + ], + "payer": { + "first_name": "Nome", + "last_name": "Sobrenome", + "is_prime_user": "1", + "is_first_purchase_online": "1", + "last_purchase": "2019-10-25T19:30:00.000-03:00", + "phone": { + "area_code": "11", + "number": "987654321" + }, + "address": { + "zip_code": "206233-2002", + "street_name": "Av. das Nações Unidas", + "street_number": "3003" + }, + "authentication_type": "Facebook", + "registration_date": "2020-08-06T09:25:04.000-03:00" + }, + "shipments": { + "express_shipment": "1", + "receiver_address": { + "zip_code": "306233-2003", + "street_name": "Av. das Nações Unidas", + "street_number": "3003", + "floor": "5", + "apartment": "502", + "state_name":"SP", + "city_name":"Osasco" + } + } + } +}' +``` \ No newline at end of file diff --git a/guides/checkout-api-v2/industry-data/home-and-deco.pt.md b/guides/checkout-api-v2/industry-data/home-and-deco.pt.md new file mode 100644 index 0000000000..4b09908b37 --- /dev/null +++ b/guides/checkout-api-v2/industry-data/home-and-deco.pt.md @@ -0,0 +1,141 @@ +# Casa e decoração + +Estes são os dados específicos para a indústria de **casa e decoração** que podem ser adicionados à sua integração para melhorar a aprovação dos pagamentos. + +## Campos para enviar + +Adicione qualquer informação extra que considerar necessária. + +### Sobre itens + +----[mla, mlm, mlu, mco, mlb, mpe]---- +| Array `items` | Tipo | Descrição | +| --- | --- | --- | +| `id` | String | Código de identificação do item. | +| `title` | String | Nome do item. | +| `description` | String | Descrição do item. | +| `category_id` | String | Categoria do item. | +| `quantity` | Integer | Quantidade de unidades do item. | +| `unit_price` | Float | Preço unitário atribuído ao item. Pode ser um valor inteiro ou em casas decimais. | +| `warranty` | Boolean | Caso o produto tenha garantia, use `true` e, caso não tenha, use `false`. | +------------ + +----[mlc]---- +| Array `items` | Tipo | Descrição | +| --- | --- | --- | +| `id` | String | Código de identificação do item. | +| `title` | String | Nome do item. | +| `description` | String | Descrição do item. | +| `category_id` | String | Categoria do item. | +| `quantity` | Integer | Quantidade de unidades do item. | +| `unit_price` | Float | Preço unitário atribuído ao item. Deve ser um valor inteiro. | +| `warranty` | Boolean | Caso o produto tenha garantia, use `true` e, caso não tenha, use `false`. | +------------ + +### Sobre o comprador + +| Object `payer` | Tipo | Descrição | +| --- | --- | --- | +| `first_name` | String | Nome do comprador. | +| `last_name` | String | Sobrenome do comprador. | +| `identification` | Object | Dados de identificação do comprador. | +| `type` | String | Tipo de identificação. Está dentro do objeto `identification`. | +| `number` | String | Número de identificação. Está dentro do objeto `identification`. | +| `phone` | Object | Telefone do comprador. | +| `area_code` | Integer | Código de área do comprador. Está dentro do objeto `phone`. | +| `number` | Integer | Número de telefone do comprador. Está dentro do objeto `phone`. | +| `address` | Object | Dados do endereço do comprador. | +| `zip_code` | String | Código postal do comprador. Está dentro do objeto `address`. | +| `street_name` | String | Nome da rua do endereço do comprador. Está dentro do objeto `address`. | +| `street_number` | Integer | Número da rua do endereço do comprador. Está dentro do objeto `address`. | +| `authentication_type` | Enum | Tipo de autenticação. Pode ser "Gmail", "Facebook", "Web Nativa" ou "Outro". | +| `registration_date` | Date | Data de registro do comprador no site. | +| `is_prime_user` | Boolean | Indica se o usuário é *premium*. Caso seja, use `true` e, caso não seja, use `false`. | +| `is_first_purchase_online` | Boolean | Indica se é a primeira compra do cliente. Caso seja, use `true` e, caso não seja, use `false`. | +| `last_purchase` | Date | Data da última compra no site. | + +### Sobre remessa + +| Object `shipment` | Tipo | Descrição | +| --- | --- | --- | +| `receiver_address` | Object | Dados do endereço da entrega. | +| `zip_code` | String | Código postal para a entrega. | +| `state_name` | String | Estado para onde o pedido é enviado. | +| `city_name` | String | Cidade para onde o pedido é enviado. | +| `street_number` | Integer | Número da rua da entrega. | +| `express_shipment` | Boolean | Indica se a entrega é expressa. Caso seja, use `true` e, caso não seja, use `false`. | + +```curl +curl --location 'https://api.mercadopago.com/v1/payments' \ +--header 'Content-Type: application/json' \ +--header 'X-Idempotency-Key: {{uuid}}' \ +--header 'Authorization: Bearer ACCESS_TOKEN' \ +--header 'X-Meli-Session-Id: {{device_id}} \ +--data-raw '{ + "transaction_amount": 150.00, + "installments": 1, + "statement_descriptor": "LOJA 123", + "capture": true, + "binary_mode": false, + "sponsor_id": null, + "application_fee": null, + "payment_method_id": "debvisa", + "token": "{{card_token_id}}", + "external_reference": "Pedido01", + "description": "PEDIDO NOVO", + "notification_url": "{{notification_url}}", + "metadata": { + "order_number": "order_01" + }, + "payer": { + "email": "test_user_123456789@testuser.com", + "identification": { + "type": "CPF", + "number": "12345678909" + } + }, + "additional_info": { + "items": [ + { + "id": "1234", + "title": "Serviço", + "warranty": true, + "description": "Descrição de serviço", + "category_id": "kitchen", + "quantity": 1, + "unit_price": 150 + } + ], + "payer": { + "first_name": "Nome", + "last_name": "Sobrenome", + "is_prime_user": "1", + "is_first_purchase_online": "1", + "last_purchase": "2019-10-25T19:30:00.000-03:00", + "phone": { + "area_code": "11", + "number": "987654321" + }, + "address": { + "zip_code": "206233-2002", + "street_name": "Av. das Nações Unidas", + "street_number": "3003" + }, + "authentication_type": "Facebook", + "registration_date": "2020-08-06T09:25:04.000-03:00" + }, + "shipments": { + "express_shipment": "1", + "receiver_address": { + "zip_code": "306233-2003", + "street_name": "Av. das Nações Unidas", + "street_number": "3003", + "floor": "5", + "apartment": "502", + "state_name":"SP", + "city_name":"Osasco" + } + } + } +}' +``` \ No newline at end of file diff --git a/guides/checkout-api-v2/industry-data/hospitality.en.md b/guides/checkout-api-v2/industry-data/hospitality.en.md new file mode 100644 index 0000000000..cbc4ecac52 --- /dev/null +++ b/guides/checkout-api-v2/industry-data/hospitality.en.md @@ -0,0 +1,139 @@ +# Hospitality + +These are the specific data for the **hospitality** industry that you can add to your integration to improve payment approval. + +## Fields to send + +Add any additional information that you consider necessary. + +### About the items + +----[mla, mlm, mlu, mco, mlb, mpe]---- +| Array `items` | Type | Description | +| --- | --- | --- | +| `id` | String | Item identification code. | +| `title` | String | Item name. | +| `category_id` | String | Category. | +| `quantity` | Integer | Quantity of the items. | +| `unit_price` | Float | Unit price assigned to the item. It can be an integer or a decimal. | +| `event_date` | Date | Event date. | +| `category_descriptor` | Object | Description of the category. | +| `passenger` | Object | Additional passenger information. | +| `first_name`| String | Passenger's first name. | +| `last_name` | String | Passenger's last name. | +| `identification` | Object | Passenger identification information. | +| `type` | String | Type of passenger identification. It is found within the `identification` object. | +| `number` | String | Passenger's identification number. It is found within the `identification` object. | +------------ + +----[mlc]---- +| Array `items` | Type | Description | +| --- | --- | --- | +| `id` | String | Item identification code. | +| `title` | String | Item name. | +| `category_id` | String | Category. | +| `quantity` | Integer | Quantity of the items. | +| `unit_price` | Float | Unit price assigned to the item. It must be an integer. | +| `event_date` | Date | Event date. | +| `category_descriptor` | Object | Description of the category. | +| `passenger` | Object | Additional passenger information. | +| `first_name`| String | Passenger's first name. | +| `last_name` | String | Passenger's last name. | +| `identification` | Object | Passenger identification information. | +| `type` | String | Type of passenger identification. It is found within the `identification` object. | +| `number` | String | Passenger's identification number. It is found within the `identification` object. | +------------ + +### About the buyer + +| 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". | +| `registration_date` | 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. | + +```curl +curl --location 'https://api.mercadopago.com/v1/payments' \ +--header 'Content-Type: application/json' \ +--header 'X-Idempotency-Key: {{uuid}}' \ +--header 'Authorization: Bearer ACCESS_TOKEN' \ +--header 'X-Meli-Session-Id: {{device_id}} \ +--data-raw '{ + "transaction_amount": 800.00, + "installments": 1, + "statement_descriptor": "Hotel 123", + "capture": true, + "binary_mode": false, + "sponsor_id": null, + "application_fee": null, + "payment_method_id": "debvisa", + "token": "{{card_token_id}}", + "external_reference": "Reference01", + "description": "Room 1002 - 3 nights", + "notification_url": "{{notification_url}}", + "metadata": { + "order_number": "order_01" + }, + "payer": { + "email": "test_user_123456789@testuser.com", + "identification": { + "type": "CPF", + "number": "12345678909" + } + }, + "additional_info": { + "items": [ + { + "id": "1234", + "title": "Serviço", + "event_date": "2019-12-25T19:30:00.000-03:00", + "category_id": "accommodations", + "category_descriptor": { + "passenger": { + "first_name": "Guest Nome", + "last_name": "Guest Sobrenome", + "identification": { + "type": "DNI", + "number": "012345678" + } + } + }, + "quantity": 1, + "unit_price": 800 + } + ], + "payer": { + "first_name": "Nome", + "last_name": "Sobrenome", + "is_prime_user": "1", + "is_first_purchase_online": "1", + "last_purchase": "2019-10-25T19:30:00.000-03:00", + "phone": { + "area_code": "11", + "number": "987654321" + }, + "address": { + "zip_code": "206233-2002", + "street_name": "Av. das Nações Unidas", + "street_number": "230032" + }, + "authentication_type": "Facebook", + "registration_date": "2020-08-06T09:25:04.000-03:00" + } + } +}' +``` \ No newline at end of file diff --git a/guides/checkout-api-v2/industry-data/hospitality.es.md b/guides/checkout-api-v2/industry-data/hospitality.es.md new file mode 100644 index 0000000000..962e356ecf --- /dev/null +++ b/guides/checkout-api-v2/industry-data/hospitality.es.md @@ -0,0 +1,139 @@ +# Hotelería + +Estos son los datos específicos para la industria **hotelería** que puedes agregar a tu integración para mejorar la aprobación de los pagos. + +## Campos a enviar + +Agrega toda la información adicional que consideres necesaria. + +### Sobre los ítems + +----[mla, mlm, mlu, mco, mlb, mpe]---- +| Array `items` | Tipo | Descripción | +| --- | --- | --- | +| `id` | String | Código de identificación del ítem. | +| `title` | String | Nombre del ítem. | +| `category_id` | String | Categoría del ítem. | +| `quantity` | Integer | Cantidad de unidades para el ítem. | +| `unit_price` | Float | Precio unitario asignado al ítem. Puede ser entero o con decimales. | +| `event_date` | Date | Fecha del evento. | +| `category_descriptor` | Object | Descripción de la categoría. | +| `passenger` | Object | Información adicional del pasajero. | +| `first_name`| String | Nombre del pasajero. | +| `last_name` | String | Apellido del pasajero. | +| `identification` | Object | Información de identificación del pasajero. | +| `type` | String | Tipo de identificación del pasajero. Se encuentra dentro del objeto `identification`. | +| `number` | String | Número de identificación del pasajero. Se encuentra dentro del objeto `identification`. | +------------ + +----[mlc]---- +| Array `items` | Tipo | Descripción | +| --- | --- | --- | +| `id` | String | Código de identificación del ítem. | +| `title` | String | Nombre del ítem. | +| `category_id` | String | Categoría del ítem. | +| `quantity` | Integer | Cantidad de unidades para el ítem. | +| `unit_price` | Float | Precio unitario asignado al ítem. Debe ser un número entero. | +| `event_date` | Date | Fecha del evento. | +| `category_descriptor` | Object | Descripción de la categoría. | +| `passenger` | Object | Información adicional del pasajero. | +| `first_name`| String | Nombre del pasajero. | +| `last_name` | String | Apellido del pasajero. | +| `identification` | Object | Información de identificación del pasajero. | +| `type` | String | Tipo de identificación del pasajero. Se encuentra dentro del objeto `identification`. | +| `number` | String | Número de identificación del pasajero. Se encuentra dentro del objeto `identification`. | +------------ + +### Sobre el comprador + +| Object `payer` | Tipo | Descripción | +| --- | --- | --- | +| `first_name` | String | Nombre del comprador. | +| `last_name` | String | Apellido del comprador. | +| `identification` | Object | Datos de identificación del comprador. | +| `type` | String | Tipo de identificación. Se encuentra dentro del objeto `identification`. | +| `number` | String | Número de identificación. Se encuentra dentro del objeto `identification`. | +| `phone` | Object | Teléfono del comprador. | +| `area_code` | Integer | Código de área del comprador. Se encuentra dentro del objeto `phone`. | +| `number` | Integer | Número de teléfono del comprador. Se encuentra dentro del objeto `phone`. | +| `address` | Object | Datos del domicilio del comprador. | +| `zip_code` | String | Código postal del comprador. Se encuentra dentro del objeto `address`. | +| `street_name` | String | Nombre de calle del domicilio del comprador. Se encuentra dentro del objeto `address`. | +| `street_number` | Integer | Número de calle del domicilio del comprador. Se encuentra dentro del objeto `address`. | +| `authentication_type` | Enum | Tipo de autenticación. Pueden ser "Gmail", "Facebook", "Web Nativa" u "Otro". | +| `registration_date` | Date | Fecha de registro del comprador en el sitio. | +| `is_prime_user` | Boolean | Indica si el usuario es premium. Coloca `true` si lo es o `false` si no lo es. | +| `is_first_purchase_online` | Boolean | Indica si es la primera compra del cliente. Coloca `true` si lo es o `false` si no lo es. | +| `last_purchase` | Date | Fecha de la última compra en el sitio. | + +```curl +curl --location 'https://api.mercadopago.com/v1/payments' \ +--header 'Content-Type: application/json' \ +--header 'X-Idempotency-Key: {{uuid}}' \ +--header 'Authorization: Bearer ACCESS_TOKEN' \ +--header 'X-Meli-Session-Id: {{device_id}} \ +--data-raw '{ + "transaction_amount": 800.00, + "installments": 1, + "statement_descriptor": "Hotel 123", + "capture": true, + "binary_mode": false, + "sponsor_id": null, + "application_fee": null, + "payment_method_id": "debvisa", + "token": "{{card_token_id}}", + "external_reference": "Reference01", + "description": "Room 1002 - 3 nights", + "notification_url": "{{notification_url}}", + "metadata": { + "order_number": "order_01" + }, + "payer": { + "email": "test_user_123456789@testuser.com", + "identification": { + "type": "CPF", + "number": "12345678909" + } + }, + "additional_info": { + "items": [ + { + "id": "1234", + "title": "Serviço", + "event_date": "2019-12-25T19:30:00.000-03:00", + "category_id": "accommodations", + "category_descriptor": { + "passenger": { + "first_name": "Guest Nome", + "last_name": "Guest Sobrenome", + "identification": { + "type": "DNI", + "number": "012345678" + } + } + }, + "quantity": 1, + "unit_price": 800 + } + ], + "payer": { + "first_name": "Nome", + "last_name": "Sobrenome", + "is_prime_user": "1", + "is_first_purchase_online": "1", + "last_purchase": "2019-10-25T19:30:00.000-03:00", + "phone": { + "area_code": "11", + "number": "987654321" + }, + "address": { + "zip_code": "206233-2002", + "street_name": "Av. das Nações Unidas", + "street_number": "230032" + }, + "authentication_type": "Facebook", + "registration_date": "2020-08-06T09:25:04.000-03:00" + } + } +}' +``` \ No newline at end of file diff --git a/guides/checkout-api-v2/industry-data/hospitality.pt.md b/guides/checkout-api-v2/industry-data/hospitality.pt.md new file mode 100644 index 0000000000..fa17f291b9 --- /dev/null +++ b/guides/checkout-api-v2/industry-data/hospitality.pt.md @@ -0,0 +1,139 @@ +# Hospitalidade + +Estes são os dados específicos para a indústria de **hospitalidade** que podem ser adicionados à sua integração para melhorar a aprovação dos pagamentos. + +## Campos para enviar + +Adicione qualquer informação extra que considerar necessária. + +### Sobre itens + +----[mla, mlm, mlu, mco, mlb, mpe]---- +| Array `items` | Tipo | Descrição | +| --- | --- | --- | +| `id` | String | Código de identificação do item. | +| `title` | String | Nome do item. | +| `category_id` | String | Categoria do item. | +| `quantity` | Integer | Quantidade de unidades do item. | +| `unit_price` | Float | Preço unitário atribuído ao item. Pode ser um valor inteiro ou em casas decimais. | +| `event_date` | Date | Data do evento. | +| `category_descriptor` | Object | Descrição da categoria. | +| `passenger` | Object | Informações adicionais sobre passageiros. | +| `first_name`| String | Nome do passageiro. | +| `last_name` | String | Sobrenome do passageiro. | +| `identification` | Object | Informações de identificação do passageiro. | +| `type` | String | Tipo de identificação do passageiro. Está dentro do objeto `identification`. | +| `number` | String | Número de identificação do passageiro. Está dentro do objeto `identification`. | +------------ + +----[mlc]---- +| Array `items` | Tipo | Descrição | +| --- | --- | --- | +| `id` | String | Código de identificação do item. | +| `title` | String | Nome do item. | +| `category_id` | String | Categoria do item. | +| `quantity` | Integer | Quantidade de unidades do item. | +| `unit_price` | Float | Preço unitário atribuído ao item. Deve ser um valor inteiro. | +| `event_date` | Date | Data do evento. | +| `category_descriptor` | Object | Descrição da categoria. | +| `passenger` | Object | Informações adicionais sobre passageiros. | +| `first_name`| String | Nome do passageiro. | +| `last_name` | String | Sobrenome do passageiro. | +| `identification` | Object | Informações de identificação do passageiro. | +| `type` | String | Tipo de identificação do passageiro. Está dentro do objeto `identification`. | +| `number` | String | Número de identificação do passageiro. Está dentro do objeto `identification`. | +------------ + +### Sobre o comprador + +| Object `payer` | Tipo | Descrição | +| --- | --- | --- | +| `first_name` | String | Nome do comprador. | +| `last_name` | String | Sobrenome do comprador. | +| `identification` | Object | Dados de identificação do comprador. | +| `type` | String | Tipo de identificação. Está dentro do objeto `identification`. | +| `number` | String | Número de identificação. Está dentro do objeto `identification`. | +| `phone` | Object | Telefone do comprador. | +| `area_code` | Integer | Código de área do comprador. Está dentro do objeto `phone`. | +| `number` | Integer | Número de telefone do comprador. Está dentro do objeto `phone`. | +| `address` | Object | Dados do endereço do comprador. | +| `zip_code` | String | Código postal do comprador. Está dentro do objeto `address`. | +| `street_name` | String | Nome da rua do endereço do comprador. Está dentro do objeto `address`. | +| `street_number` | Integer | Número da rua do endereço do comprador. Está dentro do objeto `address`. | +| `authentication_type` | Enum | Tipo de autenticação. Pode ser "Gmail", "Facebook", "Web Nativa" ou "Outro". | +| `registration_date` | Date | Data de registro do comprador no site. | +| `is_prime_user` | Boolean | Indica se o usuário é *premium*. Caso seja, use `true` e, caso não seja, use `false`. | +| `is_first_purchase_online` | Boolean | Indica se é a primeira compra do cliente. Caso seja, use `true` e, caso não seja, use `false`. | +| `last_purchase` | Date | Data da última compra no site. | + +```curl +curl --location 'https://api.mercadopago.com/v1/payments' \ +--header 'Content-Type: application/json' \ +--header 'X-Idempotency-Key: {{uuid}}' \ +--header 'Authorization: Bearer ACCESS_TOKEN' \ +--header 'X-Meli-Session-Id: {{device_id}} \ +--data-raw '{ + "transaction_amount": 800.00, + "installments": 1, + "statement_descriptor": "Hotel 123", + "capture": true, + "binary_mode": false, + "sponsor_id": null, + "application_fee": null, + "payment_method_id": "debvisa", + "token": "{{card_token_id}}", + "external_reference": "Reference01", + "description": "Room 1002 - 3 nights", + "notification_url": "{{notification_url}}", + "metadata": { + "order_number": "order_01" + }, + "payer": { + "email": "test_user_123456789@testuser.com", + "identification": { + "type": "CPF", + "number": "12345678909" + } + }, + "additional_info": { + "items": [ + { + "id": "1234", + "title": "Serviço", + "event_date": "2019-12-25T19:30:00.000-03:00", + "category_id": "accommodations", + "category_descriptor": { + "passenger": { + "first_name": "Guest Nome", + "last_name": "Guest Sobrenome", + "identification": { + "type": "DNI", + "number": "012345678" + } + } + }, + "quantity": 1, + "unit_price": 800 + } + ], + "payer": { + "first_name": "Nome", + "last_name": "Sobrenome", + "is_prime_user": "1", + "is_first_purchase_online": "1", + "last_purchase": "2019-10-25T19:30:00.000-03:00", + "phone": { + "area_code": "11", + "number": "987654321" + }, + "address": { + "zip_code": "206233-2002", + "street_name": "Av. das Nações Unidas", + "street_number": "230032" + }, + "authentication_type": "Facebook", + "registration_date": "2020-08-06T09:25:04.000-03:00" + } + } +}' +``` \ No newline at end of file diff --git a/guides/checkout-api-v2/industry-data/industry-data-intro.en.md b/guides/checkout-api-v2/industry-data/industry-data-intro.en.md new file mode 100644 index 0000000000..835c87e445 --- /dev/null +++ b/guides/checkout-api-v2/industry-data/industry-data-intro.en.md @@ -0,0 +1,19 @@ +# Additional industry data + +Depending on the branch of activities or industry of your store, there is a series of data that can be sent when creating a payment that will help improve your approval. You can see them detailed by industry following the links below. + +* [Apparel](/developers/en/docs/checkout-api/additional-content/industry-data/apparel) +* [Electro](/developers/en/docs/checkout-api/additional-content/industry-data/electro) +* [Tickets and entertainment](/developers/en/docs/checkout-api/additional-content/industry-data/tickets-and-entretainment) +* [Home & deco](/developers/es/docs/checkout-api/additional-content/industry-data/home-and-deco) +* [Applications and online platforms](/developers/en/docs/checkout-api/additional-content/industry-data/applications-online-platforms) +* [Retail](/developers/es/docs/checkout-api/additional-content/industry-data/retail) +* [Government and public services](/developers/en/docs/checkout-api/additional-content/industry-data/goverment-public-services) +* [Tourism](/developers/en/docs/checkout-api/additional-content/industry-data/tourism) +* [Hospitality](/developers/en/docs/checkout-api/additional-content/industry-data/hospitality) +* [Utilities](/developers/en/docs/checkout-api/additional-content/industry-data/utilities) +* [Direct sale](/developers/en/docs/checkout-api/additional-content/industry-data/direct-sale) +* [Automobiles and nautical](/developers/en/docs/checkout-api/additional-content/industry-data/automobiles-and-nautical) +* [Urban transport](/developers/en/docs/checkout-api/additional-content/industry-data/urban-transport) +* [Gambling](/developers/en/docs/checkout-api/additional-content/industry-data/gambling) + diff --git a/guides/checkout-api-v2/industry-data/industry-data-intro.es.md b/guides/checkout-api-v2/industry-data/industry-data-intro.es.md new file mode 100644 index 0000000000..9335244b4b --- /dev/null +++ b/guides/checkout-api-v2/industry-data/industry-data-intro.es.md @@ -0,0 +1,21 @@ +# Datos adicionales sobre industrias + +Dependiendo del ramo de actividades o industria de tu tienda, existen una serie de datos que pueden ser enviados al crear un pago que ayudarán a mejorar tu aprobación. Puedes verlos detallados por industria siguiendo los enlaces a continuación. + +* [Apparel](/developers/es/docs/checkout-api/additional-content/industry-data/apparel) +* [Electro](/developers/es/docs/checkout-api/additional-content/industry-data/electro) +* [Tickets y entretenimiento](/developers/es/docs/checkout-api/additional-content/industry-data/tickets-and-entretainment) +* [Home & deco](/developers/es/docs/checkout-api/additional-content/industry-data/home-and-deco) +* [Aplicaciones y plataformas online](/developers/es/docs/checkout-api/additional-content/industry-data/applications-online-platforms) +* [Retail](/developers/es/docs/checkout-api/additional-content/industry-data/retail) +* [Gobierno y servicios públicos](/developers/es/docs/checkout-api/additional-content/industry-data/goverment-public-services) +* [Turismo](/developers/es/docs/checkout-api/additional-content/industry-data/tourism) +* [Hotelería](/developers/es/docs/checkout-api/additional-content/industry-data/hospitality) +* [Utilities](/developers/es/docs/checkout-api/additional-content/industry-data/utilities) +* [Venta directa](/developers/es/docs/checkout-api/additional-content/industry-data/direct-sale) +* [Automóviles y náuticas](/developers/es/docs/checkout-api/additional-content/industry-data/automobiles-and-nautical) +* [Transporte urbano](/developers/es/docs/checkout-api/additional-content/industry-data/urban-transport) +* [Gambling](/developers/es/docs/checkout-api/additional-content/industry-data/gambling) + + + diff --git a/guides/checkout-api-v2/industry-data/industry-data-intro.pt.md b/guides/checkout-api-v2/industry-data/industry-data-intro.pt.md new file mode 100644 index 0000000000..1886bda74c --- /dev/null +++ b/guides/checkout-api-v2/industry-data/industry-data-intro.pt.md @@ -0,0 +1,20 @@ +# Dados adicionais de indústria + +Dependendo do ramo de atividades ou setor de sua loja, existe uma série de dados que podem ser enviados na hora de gerar um pagamento e que vão ajudar a melhorar sua aprovação. Você pode vê-los detalhados por setor seguindo os links abaixo. + +* [Apparel](/developers/pt/docs/checkout-api/additional-content/industry-data/apparel) +* [Eletro](/developers/pt/docs/checkout-api/additional-content/industry-data/electro) +* [Tickets e entretenimento](/developers/pt/docs/checkout-api/additional-content/industry-data/tickets-and-entretainment) +* [Casa e decoração](/developers/pt/docs/checkout-api/additional-content/industry-data/home-and-deco) +* [Aplicativos e plataformas online](/developers/pt/docs/checkout-api/additional-content/industry-data/applications-online-platforms) +* [Retail](/developers/es/docs/checkout-api/additional-content/industry-data/retail) +* [Serviços governamentais e públicos](/developers/pt/docs/checkout-api/additional-content/industry-data/goverment-public-services) +* [Turismo](/developers/pt/docs/checkout-api/additional-content/industry-data/tourism) +* [Hospitalidade](/developers/pt/docs/checkout-api/additional-content/industry-data/hospitality) +* [Utilities](/developers/pt/docs/checkout-api/additional-content/industry-data/utilities) +* [Venda direta](/developers/pt/docs/checkout-api/additional-content/industry-data/direct-sale) +* [Automóveis e náutica](/developers/pt/docs/checkout-api/additional-content/industry-data/automobiles-and-nautical) +* [Transporte urbano](/developers/pt/docs/checkout-api/additional-content/industry-data/urban-transport) +* [Gambling](/developers/pt/docs/checkout-api/additional-content/industry-data/gambling) + + diff --git a/guides/checkout-api-v2/industry-data/retail.en.md b/guides/checkout-api-v2/industry-data/retail.en.md new file mode 100644 index 0000000000..bd77f69efd --- /dev/null +++ b/guides/checkout-api-v2/industry-data/retail.en.md @@ -0,0 +1,141 @@ +# Retail + +These are the specific data for the **retail** industry that you can add to your integration to improve payment approval. + +## Fields to send + +Add any additional information that you consider necessary. + +### About items + +----[mla, mlm, mlu, mco, mlb, mpe]---- +| Array `items` | Type | Description | +| --- | --- | --- | +| `id` | String | Item identification code. | +| `title` | String | Item name. | +| `description` | String | Item description. | +| `picture_url` | String | Image URL representing the item. | +| `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. | +------------ + +----[mlc]---- +| Array `items` | Type | Description | +| --- | --- | --- | +| `id` | String | Item identification code. | +| `title` | String | Item name. | +| `description` | String | Item description. | +| `picture_url` | String | Image URL representing the item. | +| `category_id` | String | Item category. | +| `quantity` | Integer | Quantity of units for the item. | +| `unit_price` | Float | Unit price assigned to the item. It must be an integer. | +------------ + +### About the buyer + +| 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". | +| `registration_date` | 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. | + +### About shipments + +| Object `shipment` | Type | Description | +| --- | --- | --- | +| `receiver_address` | Object | Shipping address data. | +| `zip_code` | String | Postal code for the shipment. | +| `state_name` | String | Province to which the order is shipped. | +| `city_name` | String | City to which the order is shipped. | +| `street_number` | Integer | Street number of the shipment. | +| `express_shipment` | Boolean | Indicates if the shipment is express. `true` if it is, `false` if it is not. | + +```curl +curl --location 'https://api.mercadopago.com/v1/payments' \ +--header 'Content-Type: application/json' \ +--header 'X-Idempotency-Key: {{uuid}}' \ +--header 'Authorization: Bearer ACCESS_TOKEN' \ +--header 'X-Meli-Session-Id: {{device_id}} \ +--data-raw '{ + "transaction_amount": 150.00, + "installments": 1, + "statement_descriptor": "LOJA 123", + "capture": true, + "binary_mode": false, + "sponsor_id": null, + "application_fee": null, + "payment_method_id": "debvisa", + "token": "{{card_token_id}}", + "external_reference": "Pedido01", + "description": "PEDIDO NOVO", + "notification_url": "{{notification_url}}", + "metadata": { + "order_number": "order_01" + }, + "payer": { + "email": "test_user_123456789@testuser.com", + "identification": { + "type": "CPF", + "number": "12345678909" + } + }, + "additional_info": { + "items": [ + { + "id": "1234", + "title": "Serviço", + "picture_url": "{{picture_url}}", + "description": "Descrição de serviço", + "category_id": "pantry", + "quantity": 1, + "unit_price": 150 + } + ], + "payer": { + "first_name": "Nome", + "last_name": "Sobrenome", + "is_prime_user": "1", + "is_first_purchase_online": "1", + "last_purchase": "2019-10-25T19:30:00.000-03:00", + "phone": { + "area_code": "11", + "number": "987654321" + }, + "address": { + "zip_code": "206233-2002", + "street_name": "Av. das Nações Unidas", + "street_number": "3003" + }, + "authentication_type": "Facebook", + "registration_date": "2020-08-06T09:25:04.000-03:00" + }, + "shipments": { + "express_shipment": "1", + "receiver_address": { + "zip_code": "306233-2003", + "street_name": "Av. das Nações Unidas", + "street_number": "3003", + "floor": "5", + "apartment": "502", + "state_name": "DF", + "city_name": "Bogota" + } + } + } +}' +``` \ No newline at end of file diff --git a/guides/checkout-api-v2/industry-data/retail.es.md b/guides/checkout-api-v2/industry-data/retail.es.md new file mode 100644 index 0000000000..eb5657727a --- /dev/null +++ b/guides/checkout-api-v2/industry-data/retail.es.md @@ -0,0 +1,141 @@ +# Retail + +Estos son los datos específicos para la industria **retail** que puedes agregar a tu integración para mejorar la aprobación de los pagos. + +## Campos a enviar + +Agrega toda la información adicional que consideres necesaria. + +### Sobre los ítems + +----[mla, mlm, mlu, mco, mlb, mpe]---- +| Array `items` | Tipo | Descripción | +| --- | --- | --- | +| `id` | String | Código de identificación del ítem. | +| `title` | String | Nombre del ítem. | +| `description` | String | Descripción del ítem. | +| `picture_url` | String | URL de imagen que representa al ítem. | +| `category_id` | String | Categoría del ítem. | +| `quantity` | Integer | Cantidad de unidades para el ítem. | +| `unit_price` | Float | Precio unitario asignado al ítem. Puede ser entero o con decimales. | +------------ + +----[mlc]---- +| Array `items` | Tipo | Descripción | +| --- | --- | --- | +| `id` | String | Código de identificación del ítem. | +| `title` | String | Nombre del ítem. | +| `description` | String | Descripción del ítem. | +| `picture_url` | String | URL de imagen que representa al ítem. | +| `category_id` | String | Categoría del ítem. | +| `quantity` | Integer | Cantidad de unidades para el ítem. | +| `unit_price` | Float | Precio unitario asignado al ítem. Debe ser un número entero. | +------------ + +### Sobre el comprador + +| Object `payer` | Tipo | Descripción | +| --- | --- | --- | +| `first_name` | String | Nombre del comprador. | +| `last_name` | String | Apellido del comprador. | +| `identification` | Object | Datos de identificación del comprador. | +| `type` | String | Tipo de identificación. Se encuentra dentro del objeto `identification`. | +| `number` | String | Número de identificación. Se encuentra dentro del objeto `identification`. | +| `phone` | Object | Teléfono del comprador. | +| `area_code` | Integer | Código de área del comprador. Se encuentra dentro del objeto `phone`. | +| `number` | Integer | Número de teléfono del comprador. Se encuentra dentro del objeto `phone`. | +| `address` | Object | Datos del domicilio del comprador. | +| `zip_code` | String | Código postal del comprador. Se encuentra dentro del objeto `address`. | +| `street_name` | String | Nombre de calle del domicilio del comprador. Se encuentra dentro del objeto `address`. | +| `street_number` | Integer | Número de calle del domicilio del comprador. Se encuentra dentro del objeto `address`. | +| `authentication_type` | Enum | Tipo de autenticación. Pueden ser "Gmail", "Facebook", "Web Nativa" u "Otro". | +| `registration_date` | Date | Fecha de registro del comprador en el sitio. | +| `is_prime_user` | Boolean | Indica si el usuario es premium. Coloca `true` si lo es o `false` si no lo es. | +| `is_first_purchase_online` | Boolean | Indica si es la primera compra del cliente. Coloca `true` si lo es o `false` si no lo es. | +| `last_purchase` | Date | Fecha de la última compra en el sitio. | + +### Sobre envíos + +| Object `shipment` | Tipo | Descripción | +| --- | --- | --- | +| `receiver_address` | Object | Datos de dirección del envío. | +| `zip_code` | String | Código postal para el envío. | +| `state_name` | String | Provincia hacia donde se envía el pedido. | +| `city_name` | String | Ciudad hacia donde se envía el pedido. | +| `street_number` | Integer | Número de calle del envío. | +| `express_shipment` | Boolean | Indica si el envío es rápido. `true` si lo es, `false` si no lo es. | + +```curl +curl --location 'https://api.mercadopago.com/v1/payments' \ +--header 'Content-Type: application/json' \ +--header 'X-Idempotency-Key: {{uuid}}' \ +--header 'Authorization: Bearer ACCESS_TOKEN' \ +--header 'X-Meli-Session-Id: {{device_id}} \ +--data-raw '{ + "transaction_amount": 150.00, + "installments": 1, + "statement_descriptor": "LOJA 123", + "capture": true, + "binary_mode": false, + "sponsor_id": null, + "application_fee": null, + "payment_method_id": "debvisa", + "token": "{{card_token_id}}", + "external_reference": "Pedido01", + "description": "PEDIDO NOVO", + "notification_url": "{{notification_url}}", + "metadata": { + "order_number": "order_01" + }, + "payer": { + "email": "test_user_123456789@testuser.com", + "identification": { + "type": "CPF", + "number": "12345678909" + } + }, + "additional_info": { + "items": [ + { + "id": "1234", + "title": "Serviço", + "picture_url": "{{picture_url}}", + "description": "Descrição de serviço", + "category_id": "pantry", + "quantity": 1, + "unit_price": 150 + } + ], + "payer": { + "first_name": "Nome", + "last_name": "Sobrenome", + "is_prime_user": "1", + "is_first_purchase_online": "1", + "last_purchase": "2019-10-25T19:30:00.000-03:00", + "phone": { + "area_code": "11", + "number": "987654321" + }, + "address": { + "zip_code": "206233-2002", + "street_name": "Av. das Nações Unidas", + "street_number": "3003" + }, + "authentication_type": "Facebook", + "registration_date": "2020-08-06T09:25:04.000-03:00" + }, + "shipments": { + "express_shipment": "1", + "receiver_address": { + "zip_code": "306233-2003", + "street_name": "Av. das Nações Unidas", + "street_number": "3003", + "floor": "5", + "apartment": "502", + "state_name": "DF", + "city_name": "Bogota" + } + } + } +}' +``` \ No newline at end of file diff --git a/guides/checkout-api-v2/industry-data/retail.pt.md b/guides/checkout-api-v2/industry-data/retail.pt.md new file mode 100644 index 0000000000..5840a110ec --- /dev/null +++ b/guides/checkout-api-v2/industry-data/retail.pt.md @@ -0,0 +1,141 @@ +# Retail + +Estes são os dados específicos para a indústria de **retail** que podem ser adicionados à sua integração para melhorar a aprovação dos pagamentos. + +## Campos para enviar + +Adicione qualquer informação extra que considerar necessária. + +### Sobre itens + +----[mla, mlm, mlu, mco, mlb, mpe]---- +| Array `items` | Tipo | Descrição | +| --- | --- | --- | +| `id` | String | Código de identificação do item. | +| `title` | String | Nome do item. | +| `description` | String | Descrição do item. | +| `picture_url` | String | URL da imagem que representa o item. | +| `category_id` | String | Categoria do item. | +| `quantity` | Integer | Quantidade de unidades do item. | +| `unit_price` | Float | Preço unitário atribuído ao item. Pode ser um valor inteiro ou em casas decimais. | +------------ + +----[mlc]---- +| Array `items` | Tipo | Descrição | +| --- | --- | --- | +| `id` | String | Código de identificação do item. | +| `title` | String | Nome do item. | +| `description` | String | Descrição do item. | +| `picture_url` | String | URL da imagem que representa o item. | +| `category_id` | String | Categoria do item. | +| `quantity` | Integer | Quantidade de unidades do item. | +| `unit_price` | Float | Preço unitário atribuído ao item. Deve ser um valor inteiro. | +------------ + +### Sobre o comprador + +| Object `payer` | Tipo | Descrição | +| --- | --- | --- | +| `first_name` | String | Nome do comprador. | +| `last_name` | String | Sobrenome do comprador. | +| `identification` | Object | Dados de identificação do comprador. | +| `type` | String | Tipo de identificação. Está dentro do objeto `identification`. | +| `number` | String | Número de identificação. Está dentro do objeto `identification`. | +| `phone` | Object | Telefone do comprador. | +| `area_code` | Integer | Código de área do comprador. Está dentro do objeto `phone`. | +| `number` | Integer | Número de telefone do comprador. Está dentro do objeto `phone`. | +| `address` | Object | Dados do endereço do comprador. | +| `zip_code` | String | Código postal do comprador. Está dentro do objeto `address`. | +| `street_name` | String | Nome da rua do endereço do comprador. Está dentro do objeto `address`. | +| `street_number` | Integer | Número da rua do endereço do comprador. Está dentro do objeto `address`. | +| `authentication_type` | Enum | Tipo de autenticação. Pode ser "Gmail", "Facebook", "Web Nativa" ou "Outro". | +| `registration_date` | Date | Data de registro do comprador no site. | +| `is_prime_user` | Boolean | Indica se o usuário é *premium*. Caso seja, use `true` e, caso não seja, use `false`. | +| `is_first_purchase_online` | Boolean | Indica se é a primeira compra do cliente. Caso seja, use `true` e, caso não seja, use `false`. | +| `last_purchase` | Date | Data da última compra no site. | + +### Sobre envios + +| Object `shipment` | Tipo | Descrição | +| --- | --- | --- | +| `receiver_address` | Object | Dados do endereço da entrega. | +| `zip_code` | String | Código postal para a entrega. | +| `state_name` | String | Estado para onde o pedido é enviado. | +| `city_name` | String | Cidade para onde o pedido é enviado. | +| `street_number` | Integer | Número da rua da entrega. | +| `express_shipment` | Boolean | Indica se a entrega é expressa. Caso seja, use `true` e, caso não seja, use `false`. | + +```curl +curl --location 'https://api.mercadopago.com/v1/payments' \ +--header 'Content-Type: application/json' \ +--header 'X-Idempotency-Key: {{uuid}}' \ +--header 'Authorization: Bearer ACCESS_TOKEN' \ +--header 'X-Meli-Session-Id: {{device_id}} \ +--data-raw '{ + "transaction_amount": 150.00, + "installments": 1, + "statement_descriptor": "LOJA 123", + "capture": true, + "binary_mode": false, + "sponsor_id": null, + "application_fee": null, + "payment_method_id": "debvisa", + "token": "{{card_token_id}}", + "external_reference": "Pedido01", + "description": "PEDIDO NOVO", + "notification_url": "{{notification_url}}", + "metadata": { + "order_number": "order_01" + }, + "payer": { + "email": "test_user_123456789@testuser.com", + "identification": { + "type": "CPF", + "number": "12345678909" + } + }, + "additional_info": { + "items": [ + { + "id": "1234", + "title": "Serviço", + "picture_url": "{{picture_url}}", + "description": "Descrição de serviço", + "category_id": "pantry", + "quantity": 1, + "unit_price": 150 + } + ], + "payer": { + "first_name": "Nome", + "last_name": "Sobrenome", + "is_prime_user": "1", + "is_first_purchase_online": "1", + "last_purchase": "2019-10-25T19:30:00.000-03:00", + "phone": { + "area_code": "11", + "number": "987654321" + }, + "address": { + "zip_code": "206233-2002", + "street_name": "Av. das Nações Unidas", + "street_number": "3003" + }, + "authentication_type": "Facebook", + "registration_date": "2020-08-06T09:25:04.000-03:00" + }, + "shipments": { + "express_shipment": "1", + "receiver_address": { + "zip_code": "306233-2003", + "street_name": "Av. das Nações Unidas", + "street_number": "3003", + "floor": "5", + "apartment": "502", + "state_name": "DF", + "city_name": "Bogota" + } + } + } +}' +``` \ No newline at end of file diff --git a/guides/checkout-api-v2/industry-data/tickets-and-entretainment.en.md b/guides/checkout-api-v2/industry-data/tickets-and-entretainment.en.md new file mode 100644 index 0000000000..97d1c8d9ef --- /dev/null +++ b/guides/checkout-api-v2/industry-data/tickets-and-entretainment.en.md @@ -0,0 +1,108 @@ +# Tickets and entertainment + +These are the specific data for the **tickets and entertainment** industry that you can add to your integration to improve payment approval. + +## Fields to send + +Add any additional information that you consider necessary. + +### About items + +----[mla, mlm, mlu, mco, mlb, mpe]---- +| Array `items` | Type | Description | +| --- | --- | --- | +| `id` | String | Item identification code. | +| `title` | String | Item name. | +| `description` | String | Item description. | +| `category_id` | String | 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. | +| `event_date` | Date | Event date | +------------ + +----[mlc]---- +| Array `items` | Type | Description | +| --- | --- | --- | +| `id` | String | Item identification code. | +| `title` | String | Item name. | +| `description` | String | Item description. | +| `category_id` | String | Category | +| `quantity` | Integer | Quantity of units for the item. | +| `unit_price` | Float | Unit price assigned to the item. It must be an integer. | +| `event_date` | Date | Event date | +------------ + +### About the buyer + +| 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. | +| `authentication_type` | Enum | Type of authentication. It can be "Gmail", "Facebook", "Native Web", or "Other". | +| `registration_date` | 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. | + +```curl +curl --location 'https://api.mercadopago.com/v1/payments' \ +--header 'Content-Type: application/json' \ +--header 'X-Idempotency-Key: {{uuid}}' \ +--header 'Authorization: Bearer ACCESS_TOKEN' \ +--data-raw '{ + "transaction_amount": 12.34, + "installments": 1, + "statement_descriptor": "LOJA 123", + "capture": true, + "binary_mode": false, + "sponsor_id": null, + "application_fee": null, + "payment_method_id": "debvisa", + "token": "{{card_token_id}}", + "external_reference": "Pedido01", + "description": "PEDIDO NOVO - INGRESSO", + "notification_url": "{{notification_url}}", + "metadata": { + "order_number": "order_01" + }, + "payer": { + "email": "test_user_123456789@testuser.com", + "identification": { + "type": "CPF", + "number": "12345678909" + } + }, + "additional_info": { + "items": [ + { + "id": "1941", + "title": "25/08/2022 | Pista Inteira5 lote - GREEN VALLEY GRAMADO 2022", + "description": "25/08/2022 | Pista Inteira5 lote - GREEN VALLEY GRAMADO 2022", + "category_id": "Tickets", + "quantity": 1, + "unit_price": 100.00, + "event_date": "2019-12-25T19:30:00.000-03:00" + } + ], + "payer": { + "first_name": "Nome", + "last_name": "Sobrenome", + "is_prime_user": "1", + "is_first_purchase_online": "1", + "last_purchase": "2019-10-25T19:30:00.000-03:00", + "phone": { + "area_code": "11", + "number": "987654321" + }, + "registration_date": "2020-08-06T09:25:04.000-03:00", + "authentication_type":"Gmail" + } + } +}' +``` \ No newline at end of file diff --git a/guides/checkout-api-v2/industry-data/tickets-and-entretainment.es.md b/guides/checkout-api-v2/industry-data/tickets-and-entretainment.es.md new file mode 100644 index 0000000000..7580fa549b --- /dev/null +++ b/guides/checkout-api-v2/industry-data/tickets-and-entretainment.es.md @@ -0,0 +1,108 @@ +# Tickets y entretenimiento + +Estos son los datos específicos para la industria **tickets y entretenimiento** que puedes agregar a tu integración para mejorar la aprobación de los pagos. + +## Campos a enviar + +Agrega toda la información adicional que consideres necesaria. + +### Sobre los ítems + +----[mla, mlm, mlu, mco, mlb, mpe]---- +| Array `items` | Tipo | Descripción | +| --- | --- | --- | +| `id` | String | Código de identificación del ítem. | +| `title` | String | Nombre del ítem. | +| `description` | String | Descripción del ítem. | +| `category_id` | String | Categoría del ítem. | +| `quantity` | Integer | Cantidad de unidades para el ítem. | +| `unit_price` | Float | Precio unitario asignado al ítem. Puede ser entero o con decimales. | +| `event_date` | Date | Fecha del evento. | +------------ + +----[mlc]---- +| Array `items` | Tipo | Descripción | +| --- | --- | --- | +| `id` | String | Código de identificación del ítem. | +| `title` | String | Nombre del ítem. | +| `description` | String | Descripción del ítem. | +| `category_id` | String | Categoría del ítem. | +| `quantity` | Integer | Cantidad de unidades para el ítem. | +| `unit_price` | Float | Precio unitario asignado al ítem. Debe ser un número entero. | +| `event_date` | Date | Fecha del evento. | +------------ + +### Sobre el comprador + +| Object `payer` | Tipo | Descripción | +| --- | --- | --- | +| `first_name` | String | Nombre del comprador. | +| `last_name` | String | Apellido del comprador. | +| `identification` | Object | Datos de identificación del comprador. | +| `type` | String | Tipo de identificación. Se encuentra dentro del objeto `identification`. | +| `number` | String | Número de identificación. Se encuentra dentro del objeto `identification`. | +| `phone` | Object | Teléfono del comprador. | +| `area_code` | Integer | Código de área del comprador. Se encuentra dentro del objeto `phone`. | +| `number` | Integer | Número de teléfono del comprador. Se encuentra dentro del objeto `phone`. | +| `authentication_type` | Enum | Tipo de autenticación. Pueden ser "Gmail", "Facebook", "Web Nativa" u "Otro". | +| `registration_date` | Date | Fecha de registro del comprador en el sitio. | +| `is_prime_user` | Boolean | Indica si el usuario es premium. Coloca `true` si lo es o `false` si no lo es. | +| `is_first_purchase_online` | Boolean | Indica si es la primera compra del cliente. Coloca `true` si lo es o `false` si no lo es. | +| `last_purchase` | Date | Fecha de la última compra en el sitio. | + +```curl +curl --location 'https://api.mercadopago.com/v1/payments' \ +--header 'Content-Type: application/json' \ +--header 'X-Idempotency-Key: {{uuid}}' \ +--header 'Authorization: Bearer ACCESS_TOKEN' \ +--data-raw '{ + "transaction_amount": 12.34, + "installments": 1, + "statement_descriptor": "LOJA 123", + "capture": true, + "binary_mode": false, + "sponsor_id": null, + "application_fee": null, + "payment_method_id": "debvisa", + "token": "{{card_token_id}}", + "external_reference": "Pedido01", + "description": "PEDIDO NOVO - INGRESSO", + "notification_url": "{{notification_url}}", + "metadata": { + "order_number": "order_01" + }, + "payer": { + "email": "test_user_123456789@testuser.com", + "identification": { + "type": "CPF", + "number": "12345678909" + } + }, + "additional_info": { + "items": [ + { + "id": "1941", + "title": "25/08/2022 | Pista Inteira5 lote - GREEN VALLEY GRAMADO 2022", + "description": "25/08/2022 | Pista Inteira5 lote - GREEN VALLEY GRAMADO 2022", + "category_id": "Tickets", + "quantity": 1, + "unit_price": 100.00, + "event_date": "2019-12-25T19:30:00.000-03:00" + } + ], + "payer": { + "first_name": "Nome", + "last_name": "Sobrenome", + "is_prime_user": "1", + "is_first_purchase_online": "1", + "last_purchase": "2019-10-25T19:30:00.000-03:00", + "phone": { + "area_code": "11", + "number": "987654321" + }, + "registration_date": "2020-08-06T09:25:04.000-03:00", + "authentication_type":"Gmail" + } + } +}' +``` \ No newline at end of file diff --git a/guides/checkout-api-v2/industry-data/tickets-and-entretainment.pt.md b/guides/checkout-api-v2/industry-data/tickets-and-entretainment.pt.md new file mode 100644 index 0000000000..54358952d3 --- /dev/null +++ b/guides/checkout-api-v2/industry-data/tickets-and-entretainment.pt.md @@ -0,0 +1,108 @@ +# Tickets e entretenimento + +Estes são os dados específicos para a indústria de **tickets e entretenimento** que podem ser adicionados à sua integração para melhorar a aprovação dos pagamentos. + +## Campos para enviar + +Adicione qualquer informação extra que considerar necessária. + +### Sobre itens + +----[mla, mlm, mlu, mco, mlb, mpe]---- +| Array `items` | Tipo | Descrição | +| --- | --- | --- | +| `id` | String | Código de identificação do item. | +| `title` | String | Nome do item. | +| `description` | String | Descrição do item. | +| `category_id` | String | Categoria do item. | +| `quantity` | Integer | Quantidade de unidades do item. | +| `unit_price` | Float | Preço unitário atribuído ao item. Pode ser um valor inteiro ou em casas decimais. | +| `event_date` | Date | Data do evento. | +------------ + +----[mlc]---- +| Array `items` | Tipo | Descrição | +| --- | --- | --- | +| `id` | String | Código de identificação do item. | +| `title` | String | Nome do item. | +| `description` | String | Descrição do item. | +| `category_id` | String | Categoria do item. | +| `quantity` | Integer | Quantidade de unidades do item. | +| `unit_price` | Float | Preço unitário atribuído ao item. Deve ser um valor inteiro. | +| `event_date` | Date | Data do evento. | +------------ + +### Sobre o comprador + +| Object `payer` | Tipo | Descrição | +| --- | --- | --- | +| `first_name` | String | Nome do comprador. | +| `last_name` | String | Sobrenome do comprador. | +| `identification` | Object | Dados de identificação do comprador. | +| `type` | String | Tipo de identificação. Está dentro do objeto `identification`. | +| `number` | String | Número de identificação. Está dentro do objeto `identification`. | +| `phone` | Object | Telefone do comprador. | +| `area_code` | Integer | Código de área do comprador. Está dentro do objeto `phone`. | +| `number` | Integer | Número de telefone do comprador. Está dentro do objeto `phone`. | +| `authentication_type` | Enum | Tipo de autenticação. Pode ser "Gmail", "Facebook", "Web Nativa" ou "Outro". | +| `registration_date` | Date | Data de registro do comprador no site. | +| `is_prime_user` | Boolean | Indica se o usuário é *premium*. Caso seja, use `true` e, caso não seja, use `false`. | +| `is_first_purchase_online` | Boolean | Indica se é a primeira compra do cliente. Caso seja, use `true` e, caso não seja, use `false`. | +| `last_purchase` | Date | Data da última compra no site. | + +```curl +curl --location 'https://api.mercadopago.com/v1/payments' \ +--header 'Content-Type: application/json' \ +--header 'X-Idempotency-Key: {{uuid}}' \ +--header 'Authorization: Bearer ACCESS_TOKEN' \ +--data-raw '{ + "transaction_amount": 12.34, + "installments": 1, + "statement_descriptor": "LOJA 123", + "capture": true, + "binary_mode": false, + "sponsor_id": null, + "application_fee": null, + "payment_method_id": "debvisa", + "token": "{{card_token_id}}", + "external_reference": "Pedido01", + "description": "PEDIDO NOVO - INGRESSO", + "notification_url": "{{notification_url}}", + "metadata": { + "order_number": "order_01" + }, + "payer": { + "email": "test_user_123456789@testuser.com", + "identification": { + "type": "CPF", + "number": "12345678909" + } + }, + "additional_info": { + "items": [ + { + "id": "1941", + "title": "25/08/2022 | Pista Inteira5 lote - GREEN VALLEY GRAMADO 2022", + "description": "25/08/2022 | Pista Inteira5 lote - GREEN VALLEY GRAMADO 2022", + "category_id": "Tickets", + "quantity": 1, + "unit_price": 100.00, + "event_date": "2019-12-25T19:30:00.000-03:00" + } + ], + "payer": { + "first_name": "Nome", + "last_name": "Sobrenome", + "is_prime_user": "1", + "is_first_purchase_online": "1", + "last_purchase": "2019-10-25T19:30:00.000-03:00", + "phone": { + "area_code": "11", + "number": "987654321" + }, + "registration_date": "2020-08-06T09:25:04.000-03:00", + "authentication_type":"Gmail" + } + } +}' +``` \ No newline at end of file diff --git a/guides/checkout-api-v2/industry-data/tourism.en.md b/guides/checkout-api-v2/industry-data/tourism.en.md new file mode 100644 index 0000000000..fe841b1e5b --- /dev/null +++ b/guides/checkout-api-v2/industry-data/tourism.en.md @@ -0,0 +1,158 @@ +# Tourism + +These are the specific data for the **tourism** industry that you can add to your integration to improve payment approval. + +## Fields to send + +Add any additional information that you consider necessary. + +### About items + +----[mla, mlm, mlu, mco, mlb, mpe]---- +| Array `items` | Type | Description | +| --- | --- | --- | +| `id` | String | Item identification code. | +| `title` | String | Item name. | +| `description` | String | Item description. | +| `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. | +| `category_descriptor` | Object | Object that contains specific information related to the industry. | +| `passenger` | Object | Passenger information. It is found within the `category_descriptor` object. | +| `first_name` | String | Passenger's first name. It is found within the `passenger` object. | +| `last_name` | String | Passenger's last name. It is found within the `passenger` object. | +| `identification` | Object | Passenger identification information. | +| `type` | String | Type of passenger identification. It is found within the `identification` object. | +| `number` | String | Passenger identification number. It is found within the `identification` object. | +| `route` | Object | Route information. It is found within the `category_descriptor` object. | +| `departure` | String | Departure location of the route. | +| `destination` | String | Destination location of the route. | +| `departure_date_time` | Date | Departure date and time of the route. | +| `arrival_date_time` | Date | Arrival date and time of the route. | +| `company` | String | Company responsible for executing the route. | +------------ + +----[mlc]---- +| Array `items` | Type | Description | +| --- | --- | --- | +| `id` | String | Item identification code. | +| `title` | String | Item name. | +| `description` | String | Item description. | +| `category_id` | String | Item category. | +| `quantity` | Integer | Quantity of units for the item. | +| `unit_price` | Float | Unit price assigned to the item. It must be an integer. | +| `category_descriptor` | Object | Object that contains specific information related to the industry. | +| `passenger` | Object | Passenger information. It is found within the `category_descriptor` object. | +| `first_name` | String | Passenger's first name. It is found within the `passenger` object. | +| `last_name` | String | Passenger's last name. It is found within the `passenger` object. | +| `identification` | Object | Passenger identification information. | +| `type` | String | Type of passenger identification. It is found within the `identification` object. | +| `number` | String | Passenger identification number. It is found within the `identification` object. | +| `route` | Object | Route information. It is found within the `category_descriptor` object. | +| `departure` | String | Departure location of the route. | +| `destination` | String | Destination location of the route. | +| `departure_date_time` | Date | Departure date and time of the route. | +| `arrival_date_time` | Date | Arrival date and time of the route. | +| `company` | String | Company responsible for executing the route. | +------------ + +### About the buyer + +| 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". | +| `registration_date` | 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. | + +```curl +curl --location 'https://api.mercadopago.com/v1/payments' \ +--header 'Content-Type: application/json' \ +--header 'X-Idempotency-Key: {{uuid}}' \ +--header 'Authorization: Bearer ACCESS_TOKEN' \ +--header 'X-Meli-Session-Id: {{device_id}} \ +--data-raw '{ + "transaction_amount": 1500.00, + "installments": 1, + "statement_descriptor": "LOJA 123", + "capture": true, + "binary_mode": false, + "sponsor_id": null, + "application_fee": null, + "payment_method_id": "debvisa", + "token": "{{card_token_id}}", + "external_reference": "Ticket01", + "description": "BOG - GRU", + "notification_url": "{{notification_url}}", + "metadata": { + "order_number": "order_01" + }, + "payer": { + "email": "test_user_123456789@testuser.com", + "identification": { + "type": "CPF", + "number": "12345678909" + } + }, + "additional_info": { + "items": [ + { + "id": "1234", + "title": "Serviço", + "description": "Descrição de serviço", + "category_id": "travels", + "category_descriptor": { + "passenger": { + "first_name": "Passenger Nome", + "last_name": "Passenger Sobrenome", + "identification": { + "type": "DNI", + "number": "012345678" + } + }, + "route": { + "departure": "Osasco", + "destination": "Sao Paulo", + "departure_date_time": "2022-03-12T12:58:41.425-04:00", + "arrival_date_time": "2022-03-14T12:58:41.425-04:00", + "company": "Companhia" + } + }, + "quantity": 1, + "unit_price": 1500 + } + ], + "payer": { + "first_name": "Nome", + "last_name": "Sobrenome", + "is_prime_user": "1", + "is_first_purchase_online": "1", + "last_purchase": "2019-10-25T19:30:00.000-03:00", + "phone": { + "area_code": "11", + "number": "987654321" + }, + "address": { + "zip_code": "206233-2002", + "street_name": "Av. das Nações Unidas", + "street_number": "230032" + }, + "authentication_type": "Facebook", + "registration_date": "2020-08-06T09:25:04.000-03:00" + } + } +}' +``` \ No newline at end of file diff --git a/guides/checkout-api-v2/industry-data/tourism.es.md b/guides/checkout-api-v2/industry-data/tourism.es.md new file mode 100644 index 0000000000..8cd9277777 --- /dev/null +++ b/guides/checkout-api-v2/industry-data/tourism.es.md @@ -0,0 +1,158 @@ +# Turismo + +Estos son los datos específicos para la industria **turismo** que puedes agregar a tu integración para mejorar la aprobación de los pagos. + +## Campos a enviar + +Agrega toda la información adicional que consideres necesaria. + +### Sobre los ítems + +----[mla, mlm, mlu, mco, mlb, mpe]---- +| Array `items` | Tipo | Descripción | +| --- | --- | --- | +| `id` | String | Código de identificación del ítem. | +| `title` | String | Nombre del ítem. | +| `description` | String | Descripción del ítem. | +| `category_id` | String | Categoría del ítem. | +| `quantity` | Integer | Cantidad de unidades para el ítem. | +| `unit_price` | Float | Precio unitario asignado al ítem. Puede ser entero o con decimales. | +| `category_descriptor` | Object | Objeto que consigna información específica relacionada a la industria. | +| `passenger` | Object | Información del pasajero. Se encuentra dentro del objeto `category_descriptor`. | +| `first_name`| String | Nombre del pasajero. Se encuentra dentro del objeto `passenger`.| +| `last_name` | String | Apellido del pasajero. Se encuentra dentro del objeto `passenger`.| +| `identification` | Object | Información de identificación del pasajero. | +| `type` | String | Tipo de identificación del pasajero. Se encuentra dentro del objeto `identification`. | +| `number` | String | Número de identificación del pasajero. Se encuentra dentro del objeto `identification`. | +| `route` | Object | Información de la ruta. Se encuentra dentro del objeto `category_descriptor`.| +| `departure` | String | Lugar de partida de la ruta. | +| `destination` | String | Lugar de destino de la ruta. | +| `departure_date_time` | Date | Fecha de salida de la ruta. | +| `arrival_date_time` | Date | Fecha de llegada de la ruta. | +| `company` | String | Compañía a cargo de ejecutar la ruta. | +------------ + +----[mlc]---- +| Array `items` | Tipo | Descripción | +| --- | --- | --- | +| `id` | String | Código de identificación del ítem. | +| `title` | String | Nombre del ítem. | +| `description` | String | Descripción del ítem. | +| `category_id` | String | Categoría del ítem. | +| `quantity` | Integer | Cantidad de unidades para el ítem. | +| `unit_price` | Float | Precio unitario asignado al ítem. Debe ser un número entero. | +| `category_descriptor` | Object | Objeto que consigna información específica relacionada a la industria. | +| `passenger` | Object | Información del pasajero. Se encuentra dentro del objeto `category_descriptor`. | +| `first_name`| String | Nombre del pasajero. Se encuentra dentro del objeto `passenger`.| +| `last_name` | String | Apellido del pasajero. Se encuentra dentro del objeto `passenger`.| +| `identification` | Object | Información de identificación del pasajero. | +| `type` | String | Tipo de identificación del pasajero. Se encuentra dentro del objeto `identification`. | +| `number` | String | Número de identificación del pasajero. Se encuentra dentro del objeto `identification`. | +| `route` | Object | Información de la ruta. Se encuentra dentro del objeto `category_descriptor`.| +| `departure` | String | Lugar de partida de la ruta. | +| `destination` | String | Lugar de destino de la ruta. | +| `departure_date_time` | Date | Fecha de salida de la ruta. | +| `arrival_date_time` | Date | Fecha de llegada de la ruta. | +| `company` | String | Compañía a cargo de ejecutar la ruta. | +------------ + +### Sobre el comprador + +| Objeto `payer` | Tipo | Descripción | +| --- | --- | --- | +| `first_name` | String | Nombre del comprador. | +| `last_name` | String | Apellido del comprador. | +| `identification` | Object | Datos de identificación del comprador. | +| `type` | String | Tipo de identificación. Se encuentra dentro del objeto `identification`. | +| `number` | String | Número de identificación. Se encuentra dentro del objeto `identification`. | +| `phone` | Object | Teléfono del comprador. | +| `area_code` | Integer | Código de área del comprador. Se encuentra dentro del objeto `phone`. | +| `number` | Integer | Número de teléfono del comprador. Se encuentra dentro del objeto `phone`. | +| `address` | Object | Datos del domicilio del comprador. | +| `zip_code` | String | Código postal del comprador. Se encuentra dentro del objeto `address`. | +| `street_name` | String | Nombre de calle del domicilio del comprador. Se encuentra dentro del objeto `address`. | +| `street_number` | Integer | Número de calle del domicilio del comprador. Se encuentra dentro del objeto `address`. | +| `authentication_type` | Enum | Tipo de autenticación. Pueden ser "Gmail", "Facebook", "Web Nativa" u "Otro". | +| `registration_date` | Date | Fecha de registro del comprador en el sitio. | +| `is_prime_user` | Boolean | Indica si el usuario es premium. Coloca `true` si lo es o `false` si no lo es. | +| `is_first_purchase_online` | Boolean | Indica si es la primera compra del cliente. Coloca `true` si lo es o `false` si no lo es. | +| `last_purchase` | Date | Fecha de la última compra en el sitio. | + +```curl +curl --location 'https://api.mercadopago.com/v1/payments' \ +--header 'Content-Type: application/json' \ +--header 'X-Idempotency-Key: {{uuid}}' \ +--header 'Authorization: Bearer ACCESS_TOKEN' \ +--header 'X-Meli-Session-Id: {{device_id}} \ +--data-raw '{ + "transaction_amount": 1500.00, + "installments": 1, + "statement_descriptor": "LOJA 123", + "capture": true, + "binary_mode": false, + "sponsor_id": null, + "application_fee": null, + "payment_method_id": "debvisa", + "token": "{{card_token_id}}", + "external_reference": "Ticket01", + "description": "BOG - GRU", + "notification_url": "{{notification_url}}", + "metadata": { + "order_number": "order_01" + }, + "payer": { + "email": "test_user_123456789@testuser.com", + "identification": { + "type": "CPF", + "number": "12345678909" + } + }, + "additional_info": { + "items": [ + { + "id": "1234", + "title": "Serviço", + "description": "Descrição de serviço", + "category_id": "travels", + "category_descriptor": { + "passenger": { + "first_name": "Passenger Nome", + "last_name": "Passenger Sobrenome", + "identification": { + "type": "DNI", + "number": "012345678" + } + }, + "route": { + "departure": "Osasco", + "destination": "Sao Paulo", + "departure_date_time": "2022-03-12T12:58:41.425-04:00", + "arrival_date_time": "2022-03-14T12:58:41.425-04:00", + "company": "Companhia" + } + }, + "quantity": 1, + "unit_price": 1500 + } + ], + "payer": { + "first_name": "Nome", + "last_name": "Sobrenome", + "is_prime_user": "1", + "is_first_purchase_online": "1", + "last_purchase": "2019-10-25T19:30:00.000-03:00", + "phone": { + "area_code": "11", + "number": "987654321" + }, + "address": { + "zip_code": "206233-2002", + "street_name": "Av. das Nações Unidas", + "street_number": "230032" + }, + "authentication_type": "Facebook", + "registration_date": "2020-08-06T09:25:04.000-03:00" + } + } +}' +``` \ No newline at end of file diff --git a/guides/checkout-api-v2/industry-data/tourism.pt.md b/guides/checkout-api-v2/industry-data/tourism.pt.md new file mode 100644 index 0000000000..4baefa5b31 --- /dev/null +++ b/guides/checkout-api-v2/industry-data/tourism.pt.md @@ -0,0 +1,158 @@ +# Turismo + +Estes são os dados específicos para a indústria de **turismo** que podem ser adicionados à sua integração para melhorar a aprovação dos pagamentos. + +## Campos para enviar + +Adicione todas as informações adicionais que você deseja. + +### Sobre itens + +----[mla, mlm, mlu, mco, mlb, mpe]---- +| Array `items` | Tipo | Descrição | +| --- | --- | --- | +| `id` | String | Código de identificação do item. | +| `title` | String | Nome do item. | +| `description` | String | Descrição do item. | +| `category_id` | String | Categoria do item. | +| `quantity` | Integer | Quantidade de unidades do item. | +| `unit_price` | Float | Preço unitário atribuído ao item. Pode ser um valor inteiro ou em casas decimais. | +| `category_descriptor` | Object | Objeto que contém informações específicas relacionadas à indústria. | +| `passenger` | Object | Informação do passageiro. Está dentro do objeto `category_descriptor`. | +| `first_name` | String | Nome do passageiro. Está dentro do objeto `passenger`. | +| `last_name` | String | Sobrenome do passageiro. Está dentro do objeto `passenger`. | +| `identification` | Object | Informações de identificação do passageiro. | +| `type` | String | Tipo de identificação do passageiro. Está dentro do objeto `identification`. | +| `number` | String | Número de identificação do passageiro. Está dentro do objeto `identification`. | +| `route` | Object | Informações da rota. Está dentro do objeto `category_descriptor`. | +| `departure` | String | Local de partida da rota. | +| `destination` | String | Local de destino da rota. | +| `departure_date_time` | Date | Data e hora de saída da rota. | +| `arrival_date_time` | Date | Data e hora de chegada da rota. | +| `company` | String | Companhia responsável pela execução da rota. | +------------ + +----[mlc]---- +| Array `items` | Tipo | Descrição | +| --- | --- | --- | +| `id` | String | Código de identificação do item. | +| `title` | String | Nome do item. | +| `description` | String | Descrição do item. | +| `category_id` | String | Categoria do item. | +| `quantity` | Integer | Quantidade de unidades do item. | +| `unit_price` | Float | Preço unitário atribuído ao item. Deve ser um valor inteiro. | +| `category_descriptor` | Object | Objeto que contém informações específicas relacionadas à indústria. | +| `passenger` | Object | Informação do passageiro. Está dentro do objeto `category_descriptor`. | +| `first_name` | String | Nome do passageiro. Está dentro do objeto `passenger`. | +| `last_name` | String | Sobrenome do passageiro. Está dentro do objeto `passenger`. | +| `identification` | Object | Informações de identificação do passageiro. | +| `type` | String | Tipo de identificação do passageiro. Está dentro do objeto `identification`. | +| `number` | String | Número de identificação do passageiro. Está dentro do objeto `identification`. | +| `route` | Object | Informações da rota. Está dentro do objeto `category_descriptor`. | +| `departure` | String | Local de partida da rota. | +| `destination` | String | Local de destino da rota. | +| `departure_date_time` | Date | Data e hora de saída da rota. | +| `arrival_date_time` | Date | Data e hora de chegada da rota. | +| `company` | String | Companhia responsável pela execução da rota. | +------------ + +### Sobre o comprador + +| Object `payer` | Tipo | Descrição | +| --- | --- | --- | +| `first_name` | String | Nome do comprador. | +| `last_name` | String | Sobrenome do comprador. | +| `identification` | Object | Dados de identificação do comprador. | +| `type` | String | Tipo de identificação. Está dentro do objeto `identification`. | +| `number` | String | Número de identificação. Está dentro do objeto `identification`. | +| `phone` | Object | Telefone do comprador. | +| `area_code` | Integer | Código de área do comprador. Está dentro do objeto `phone`. | +| `number` | Integer | Número de telefone do comprador. Está dentro do objeto `phone`. | +| `address` | Object | Dados do endereço do comprador. | +| `zip_code` | String | Código postal do comprador. Está dentro do objeto `address`. | +| `street_name` | String | Nome da rua do endereço do comprador. Está dentro do objeto `address`. | +| `street_number` | Integer | Número da rua do endereço do comprador. Está dentro do objeto `address`. | +| `authentication_type` | Enum | Tipo de autenticação. Pode ser "Gmail", "Facebook", "Web Nativa" ou "Outro". | +| `registration_date` | Date | Data de registro do comprador no site. | +| `is_prime_user` | Boolean | Indica se o usuário é *premium*. Caso seja, use `true` e, caso não seja, use `false`. | +| `is_first_purchase_online` | Boolean | Indica se é a primeira compra do cliente. Caso seja, use `true` e, caso não seja, use `false`. | +| `last_purchase` | Date | Data da última compra no site. | + +```curl +curl --location 'https://api.mercadopago.com/v1/payments' \ +--header 'Content-Type: application/json' \ +--header 'X-Idempotency-Key: {{uuid}}' \ +--header 'Authorization: Bearer ACCESS_TOKEN' \ +--header 'X-Meli-Session-Id: {{device_id}} \ +--data-raw '{ + "transaction_amount": 1500.00, + "installments": 1, + "statement_descriptor": "LOJA 123", + "capture": true, + "binary_mode": false, + "sponsor_id": null, + "application_fee": null, + "payment_method_id": "debvisa", + "token": "{{card_token_id}}", + "external_reference": "Ticket01", + "description": "BOG - GRU", + "notification_url": "{{notification_url}}", + "metadata": { + "order_number": "order_01" + }, + "payer": { + "email": "test_user_123456789@testuser.com", + "identification": { + "type": "CPF", + "number": "12345678909" + } + }, + "additional_info": { + "items": [ + { + "id": "1234", + "title": "Serviço", + "description": "Descrição de serviço", + "category_id": "travels", + "category_descriptor": { + "passenger": { + "first_name": "Passenger Nome", + "last_name": "Passenger Sobrenome", + "identification": { + "type": "DNI", + "number": "012345678" + } + }, + "route": { + "departure": "Osasco", + "destination": "Sao Paulo", + "departure_date_time": "2022-03-12T12:58:41.425-04:00", + "arrival_date_time": "2022-03-14T12:58:41.425-04:00", + "company": "Companhia" + } + }, + "quantity": 1, + "unit_price": 1500 + } + ], + "payer": { + "first_name": "Nome", + "last_name": "Sobrenome", + "is_prime_user": "1", + "is_first_purchase_online": "1", + "last_purchase": "2019-10-25T19:30:00.000-03:00", + "phone": { + "area_code": "11", + "number": "987654321" + }, + "address": { + "zip_code": "206233-2002", + "street_name": "Av. das Nações Unidas", + "street_number": "230032" + }, + "authentication_type": "Facebook", + "registration_date": "2020-08-06T09:25:04.000-03:00" + } + } +}' +``` \ No newline at end of file diff --git a/guides/checkout-api-v2/industry-data/urban-transport.en.md b/guides/checkout-api-v2/industry-data/urban-transport.en.md new file mode 100644 index 0000000000..1016f11e77 --- /dev/null +++ b/guides/checkout-api-v2/industry-data/urban-transport.en.md @@ -0,0 +1,115 @@ +# Urban transport + +These are the specific data for the **urban transport** industry that you can add to your integration to improve payment approval. + +## Fields to send + +Add any additional information that you consider necessary. + +### About items + +----[mla, mlm, mlu, mco, mlb, mpe]---- +| Array `items` | Type | Description | +| --- | --- | --- | +| `id` | String | Item identification code. | +| `title` | String | Item name. | +| `description` | String | Item description. | +| `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. | +------------ + +----[mlc]---- +| Array `items` | Type | Description | +| --- | --- | --- | +| `id` | String | Item identification code. | +| `title` | String | Item name. | +| `description` | String | Item description. | +| `category_id` | String | Item category. | +| `quantity` | Integer | Quantity of units for the item. | +| `unit_price` | Float | Unit price assigned to the item. It must be an integer. | +------------ + +### About the buyer + +| 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". | +| `registration_date` | 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. | + +```curl +curl --location 'https://api.mercadopago.com/v1/payments' \ +--header 'Content-Type: application/json' \ +--header 'X-Idempotency-Key: {{uuid}}' \ +--header 'Authorization: Bearer ACCESS_TOKEN' \ +--header 'X-Meli-Session-Id: {{device_id}} \ +--data-raw '{ + "transaction_amount": 150.00, + "installments": 1, + "statement_descriptor": "LOJA 123", + "capture": true, + "binary_mode": false, + "sponsor_id": null, + "application_fee": null, + "payment_method_id": "debvisa", + "token": "{{card_token_id}}", + "external_reference": "Pedido01", + "description": "PEDIDO NOVO", + "notification_url": "{{notification_url}}", + "metadata": { + "order_number": "order_01" + }, + "payer": { + "email": "test_user_123456789@testuser.com", + "identification": { + "type": "CPF", + "number": "12345678909" + } + }, + "additional_info": { + "items": [ + { + "id": "1234", + "title": "Serviço", + "description": "Descrição de serviço", + "category_id": "service", + "quantity": 1, + "unit_price": 150 + } + ], + "payer": { + "first_name": "Nome", + "last_name": "Sobrenome", + "is_prime_user": "1", + "is_first_purchase_online": "1", + "last_purchase": "2019-10-25T19:30:00.000-03:00", + "phone": { + "area_code": "11", + "number": "987654321" + }, + "address": { + "zip_code": "206233-2002", + "street_name": "Av. das Nações Unidas", + "street_number": "230032" + }, + "authentication_type": "Facebook", + "registration_date": "2020-08-06T09:25:04.000-03:00" + } + } +}' +``` \ No newline at end of file diff --git a/guides/checkout-api-v2/industry-data/urban-transport.es.md b/guides/checkout-api-v2/industry-data/urban-transport.es.md new file mode 100644 index 0000000000..ba23014464 --- /dev/null +++ b/guides/checkout-api-v2/industry-data/urban-transport.es.md @@ -0,0 +1,115 @@ +# Transporte urbano + +Estos son los datos específicos para la industria **transporte urbano** que puedes agregar a tu integración para mejorar la aprobación de los pagos. + +## Campos a enviar + +Add any additional information that you consider necessary. + +### Sobre los ítems + +----[mla, mlm, mlu, mco, mlb, mpe]---- +| Array `items` | Tipo | Descripción | +| --- | --- | --- | +| `id` | String | Código de identificación del ítem. | +| `title` | String | Nombre del ítem. | +| `description` | String | Descripción del ítem. | +| `category_id` | String | Categoría del ítem. | +| `quantity` | Integer | Cantidad de unidades para el ítem. | +| `unit_price` | Float | Precio unitario asignado al ítem. Puede ser entero o con decimales. | +------------ + +----[mlc]---- +| Array `items` | Tipo | Descripción | +| --- | --- | --- | +| `id` | String | Código de identificación del ítem. | +| `title` | String | Nombre del ítem. | +| `description` | String | Descripción del ítem. | +| `category_id` | String | Categoría del ítem. | +| `quantity` | Integer | Cantidad de unidades para el ítem. | +| `unit_price` | Float | Precio unitario asignado al ítem. Debe ser un número entero. | +------------ + +### Sobre el comprador + +| Object `payer` | Type | Description | +| --- | --- | --- | +| `first_name` | String | Nombre del comprador. | +| `last_name` | String | Apellido del comprador. | +| `identification` | Object | Datos de identificación del comprador. | +| `type` | String | Tipo de identificación. Se encuentra dentro del objeto `identification`. | +| `number` | String | Número de identificación. Se encuentra dentro del objeto `identification`. | +| `phone` | Object | Teléfono del comprador. | +| `area_code` | Integer | Código de área del comprador. Se encuentra dentro del objeto `phone`. | +| `number` | Integer | Número de teléfono del comprador. Se encuentra dentro del objeto `phone`. | +| `address` | Object | Datos del domicilio del comprador. | +| `zip_code` | String | Código postal del comprador. Se encuentra dentro del objeto `address`. | +| `street_name` | String | Nombre de calle del domicilio del comprador. Se encuentra dentro del objeto `address`. | +| `street_number` | Integer | Número de calle del domicilio del comprador. Se encuentra dentro del objeto `address`. | +| `authentication_type` | Enum | Tipo de autenticación. Pueden ser "Gmail", "Facebook", "Web Nativa" u "Otro". | +| `registration_date` | Date | Fecha de registro del comprador en el sitio. | +| `is_prime_user` | Boolean | Indica si el usuario es premium. Coloca `true` si lo es o `false` si no lo es. | +| `is_first_purchase_online` | Boolean | Indica si es la primera compra del cliente. Coloca `true` si lo es o `false` si no lo es. | +| `last_purchase` | Date | Fecha de la última compra en el sitio. | + +```curl +curl --location 'https://api.mercadopago.com/v1/payments' \ +--header 'Content-Type: application/json' \ +--header 'X-Idempotency-Key: {{uuid}}' \ +--header 'Authorization: Bearer ACCESS_TOKEN' \ +--header 'X-Meli-Session-Id: {{device_id}} \ +--data-raw '{ + "transaction_amount": 150.00, + "installments": 1, + "statement_descriptor": "LOJA 123", + "capture": true, + "binary_mode": false, + "sponsor_id": null, + "application_fee": null, + "payment_method_id": "debvisa", + "token": "{{card_token_id}}", + "external_reference": "Pedido01", + "description": "PEDIDO NOVO", + "notification_url": "{{notification_url}}", + "metadata": { + "order_number": "order_01" + }, + "payer": { + "email": "test_user_123456789@testuser.com", + "identification": { + "type": "CPF", + "number": "12345678909" + } + }, + "additional_info": { + "items": [ + { + "id": "1234", + "title": "Serviço", + "description": "Descrição de serviço", + "category_id": "service", + "quantity": 1, + "unit_price": 150 + } + ], + "payer": { + "first_name": "Nome", + "last_name": "Sobrenome", + "is_prime_user": "1", + "is_first_purchase_online": "1", + "last_purchase": "2019-10-25T19:30:00.000-03:00", + "phone": { + "area_code": "11", + "number": "987654321" + }, + "address": { + "zip_code": "206233-2002", + "street_name": "Av. das Nações Unidas", + "street_number": "230032" + }, + "authentication_type": "Facebook", + "registration_date": "2020-08-06T09:25:04.000-03:00" + } + } +}' +``` \ No newline at end of file diff --git a/guides/checkout-api-v2/industry-data/urban-transport.pt.md b/guides/checkout-api-v2/industry-data/urban-transport.pt.md new file mode 100644 index 0000000000..9ed49d85a6 --- /dev/null +++ b/guides/checkout-api-v2/industry-data/urban-transport.pt.md @@ -0,0 +1,115 @@ +# Transporte urbano + +Estes são os dados específicos para a indústria de **transporte urbano** que podem ser adicionados à sua integração para melhorar a aprovação dos pagamentos. + +## Campos para enviar + +Adicione qualquer informação extra que considerar necessária. + +### Sobre itens + +----[mla, mlm, mlu, mco, mlb, mpe]---- +| Array `items` | Tipo | Descrição | +| --- | --- | --- | +| `id` | String | Código de identificação do item. | +| `title` | String | Nome do item. | +| `description` | String | Descrição do item. | +| `category_id` | String | Categoria do item. | +| `quantity` | Integer | Quantidade de unidades do item. | +| `unit_price` | Float | Preço unitário atribuído ao item. Pode ser um valor inteiro ou em casas decimais. | +------------ + +----[mlc]---- +| Array `items` | Tipo | Descrição | +| --- | --- | --- | +| `id` | String | Código de identificação do item. | +| `title` | String | Nome do item. | +| `description` | String | Descrição do item. | +| `category_id` | String | Categoria do item. | +| `quantity` | Integer | Quantidade de unidades do item. | +| `unit_price` | Float | Preço unitário atribuído ao item. Deve ser um valor inteiro. | +------------ + +### Sobre o comprador + +| Object `payer` | Tipo | Descrição | +| --- | --- | --- | +| `first_name` | String | Nome do comprador. | +| `last_name` | String | Sobrenome do comprador. | +| `identification` | Object | Dados de identificação do comprador. | +| `type` | String | Tipo de identificação. Está dentro do objeto `identification`. | +| `number` | String | Número de identificação. Está dentro do objeto `identification`. | +| `phone` | Object | Telefone do comprador. | +| `area_code` | Integer | Código de área do comprador. Está dentro do objeto `phone`. | +| `number` | Integer | Número de telefone do comprador. Está dentro do objeto `phone`. | +| `address` | Object | Dados do endereço do comprador. | +| `zip_code` | String | Código postal do comprador. Está dentro do objeto `address`. | +| `street_name` | String | Nome da rua do endereço do comprador. Está dentro do objeto `address`. | +| `street_number` | Integer | Número da rua do endereço do comprador. Está dentro do objeto `address`. | +| `authentication_type` | Enum | Tipo de autenticação. Pode ser "Gmail", "Facebook", "Web Nativa" ou "Outro". | +| `registration_date` | Date | Data de registro do comprador no site. | +| `is_prime_user` | Boolean | Indica se o usuário é *premium*. Caso seja, use `true` e, caso não seja, use `false`. | +| `is_first_purchase_online` | Boolean | Indica se é a primeira compra do cliente. Caso seja, use `true` e, caso não seja, use `false`. | +| `last_purchase` | Date | Data da última compra no site. | + +```curl +curl --location 'https://api.mercadopago.com/v1/payments' \ +--header 'Content-Type: application/json' \ +--header 'X-Idempotency-Key: {{uuid}}' \ +--header 'Authorization: Bearer ACCESS_TOKEN' \ +--header 'X-Meli-Session-Id: {{device_id}} \ +--data-raw '{ + "transaction_amount": 150.00, + "installments": 1, + "statement_descriptor": "LOJA 123", + "capture": true, + "binary_mode": false, + "sponsor_id": null, + "application_fee": null, + "payment_method_id": "debvisa", + "token": "{{card_token_id}}", + "external_reference": "Pedido01", + "description": "PEDIDO NOVO", + "notification_url": "{{notification_url}}", + "metadata": { + "order_number": "order_01" + }, + "payer": { + "email": "test_user_123456789@testuser.com", + "identification": { + "type": "CPF", + "number": "12345678909" + } + }, + "additional_info": { + "items": [ + { + "id": "1234", + "title": "Serviço", + "description": "Descrição de serviço", + "category_id": "service", + "quantity": 1, + "unit_price": 150 + } + ], + "payer": { + "first_name": "Nome", + "last_name": "Sobrenome", + "is_prime_user": "1", + "is_first_purchase_online": "1", + "last_purchase": "2019-10-25T19:30:00.000-03:00", + "phone": { + "area_code": "11", + "number": "987654321" + }, + "address": { + "zip_code": "206233-2002", + "street_name": "Av. das Nações Unidas", + "street_number": "230032" + }, + "authentication_type": "Facebook", + "registration_date": "2020-08-06T09:25:04.000-03:00" + } + } +}' +``` \ No newline at end of file diff --git a/guides/checkout-api-v2/industry-data/utilities.en.md b/guides/checkout-api-v2/industry-data/utilities.en.md new file mode 100644 index 0000000000..53df4bc729 --- /dev/null +++ b/guides/checkout-api-v2/industry-data/utilities.en.md @@ -0,0 +1,112 @@ +# Utilities + +These are the specific data for the **utilities** industry that you can add to your integration to improve payment approval. + +## Fields to send + +Add any additional information that you consider necessary. + +### About items + +----[mla, mlm, mlu, mco, mlb, mpe]---- +| Array `items` | Type | Description | +| --- | --- | --- | +| `id` | String | Item identification code. | +| `title` | String | Item name. | +| `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. | +------------ + +----[mlc]---- +| Array `items` | Type | Description | +| --- | --- | --- | +| `id` | String | Item identification code. | +| `title` | String | Item name. | +| `category_id` | String | Item category. | +| `quantity` | Integer | Quantity of units for the item. | +| `unit_price` | Float | Unit price assigned to the item. It must be an integer. | +------------ + +### About the buyer + +| 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". | +| `registration_date` | 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. | + +```curl +curl --location 'https://api.mercadopago.com/v1/payments' \ +--header 'Content-Type: application/json' \ +--header 'X-Idempotency-Key: {{uuid}}' \ +--header 'Authorization: Bearer ACCESS_TOKEN' \ +--header 'X-Meli-Session-Id: {{device_id}} \ +--data-raw '{ + "transaction_amount": 150.00, + "installments": 1, + "statement_descriptor": "LOJA 123", + "capture": true, + "binary_mode": false, + "sponsor_id": null, + "application_fee": null, + "payment_method_id": "debvisa", + "token": "{{card_token_id}}", + "external_reference": "Pedido01", + "description": "PEDIDO NOVO", + "notification_url": "{{notification_url}}", + "metadata": { + "order_number": "order_01" + }, + "payer": { + "email": "test_user_123456789@testuser.com", + "identification": { + "type": "CPF", + "number": "12345678909" + } + }, + "additional_info": { + "items": [ + { + "id": "1234", + "title": "Serviço", + "category_id": "service", + "quantity": 1, + "unit_price": 150 + } + ], + "payer": { + "first_name": "Nome", + "last_name": "Sobrenome", + "is_prime_user": "1", + "is_first_purchase_online": "1", + "last_purchase": "2019-10-25T19:30:00.000-03:00", + "phone": { + "area_code": "11", + "number": "987654321" + }, + "address": { + "zip_code": "206233-2002", + "street_name": "Av. das Nações Unidas", + "street_number": "3003" + }, + "authentication_type": "Facebook", + "registration_date": "2020-08-06T09:25:04.000-03:00" + } + } +}' +``` \ No newline at end of file diff --git a/guides/checkout-api-v2/industry-data/utilities.es.md b/guides/checkout-api-v2/industry-data/utilities.es.md new file mode 100644 index 0000000000..679a361c19 --- /dev/null +++ b/guides/checkout-api-v2/industry-data/utilities.es.md @@ -0,0 +1,112 @@ +# Utilities + +Estos son los datos específicos para la industria **utilities** que puedes agregar a tu integración para mejorar la aprobación de los pagos. + +## Campos a enviar + +Agrega toda la información adicional que consideres necesaria. + +### Sobre los ítems + +----[mla, mlm, mlu, mco, mlb, mpe]---- +| Array `items` | Tipo | Descripción | +| --- | --- | --- | +| `id` | String | Código de identificación del ítem. | +| `title` | String | Nombre del ítem. | +| `category_id` | String | Categoría del ítem. | +| `quantity` | Integer | Cantidad de unidades para el ítem. | +| `unit_price` | Float | Precio unitario asignado al ítem. Puede ser entero o con decimales. | +------------ + +----[mlc]---- +| Array `items` | Tipo | Descripción | +| --- | --- | --- | +| `id` | String | Código de identificación del ítem. | +| `title` | String | Nombre del ítem. | +| `category_id` | String | Categoría del ítem. | +| `quantity` | Integer | Cantidad de unidades para el ítem. | +| `unit_price` | Float | Precio unitario asignado al ítem. Debe ser un número entero. | +------------ + +### Sobre el comprador + +| Object `payer` | Tipo | Descripción | +| --- | --- | --- | +| `first_name` | String | Nombre del comprador. | +| `last_name` | String | Apellido del comprador. | +| `identification` | Object | Datos de identificación del comprador. | +| `type` | String | Tipo de identificación. Se encuentra dentro del objeto `identification`. | +| `number` | String | Número de identificación. Se encuentra dentro del objeto `identification`. | +| `phone` | Object | Teléfono del comprador. | +| `area_code` | Integer | Código de área del comprador. Se encuentra dentro del objeto `phone`. | +| `number` | Integer | Número de teléfono del comprador. Se encuentra dentro del objeto `phone`. | +| `address` | Object | Datos del domicilio del comprador. | +| `zip_code` | String | Código postal del comprador. Se encuentra dentro del objeto `address`. | +| `street_name` | String | Nombre de calle del domicilio del comprador. Se encuentra dentro del objeto `address`. | +| `street_number` | Integer | Número de calle del domicilio del comprador. Se encuentra dentro del objeto `address`. | +| `authentication_type` | Enum | Tipo de autenticación. Pueden ser "Gmail", "Facebook", "Web Nativa" u "Otro". | +| `registration_date` | Date | Fecha de registro del comprador en el sitio. | +| `is_prime_user` | Boolean | Indica si el usuario es premium. Coloca `true` si lo es o `false` si no lo es. | +| `is_first_purchase_online` | Boolean | Indica si es la primera compra del cliente. Coloca `true` si lo es o `false` si no lo es. | +| `last_purchase` | Date | Fecha de la última compra en el sitio. | + +```curl +curl --location 'https://api.mercadopago.com/v1/payments' \ +--header 'Content-Type: application/json' \ +--header 'X-Idempotency-Key: {{uuid}}' \ +--header 'Authorization: Bearer ACCESS_TOKEN' \ +--header 'X-Meli-Session-Id: {{device_id}} \ +--data-raw '{ + "transaction_amount": 150.00, + "installments": 1, + "statement_descriptor": "LOJA 123", + "capture": true, + "binary_mode": false, + "sponsor_id": null, + "application_fee": null, + "payment_method_id": "debvisa", + "token": "{{card_token_id}}", + "external_reference": "Pedido01", + "description": "PEDIDO NOVO", + "notification_url": "{{notification_url}}", + "metadata": { + "order_number": "order_01" + }, + "payer": { + "email": "test_user_123456789@testuser.com", + "identification": { + "type": "CPF", + "number": "12345678909" + } + }, + "additional_info": { + "items": [ + { + "id": "1234", + "title": "Serviço", + "category_id": "service", + "quantity": 1, + "unit_price": 150 + } + ], + "payer": { + "first_name": "Nome", + "last_name": "Sobrenome", + "is_prime_user": "1", + "is_first_purchase_online": "1", + "last_purchase": "2019-10-25T19:30:00.000-03:00", + "phone": { + "area_code": "11", + "number": "987654321" + }, + "address": { + "zip_code": "206233-2002", + "street_name": "Av. das Nações Unidas", + "street_number": "3003" + }, + "authentication_type": "Facebook", + "registration_date": "2020-08-06T09:25:04.000-03:00" + } + } +}' +``` \ No newline at end of file diff --git a/guides/checkout-api-v2/industry-data/utilities.pt.md b/guides/checkout-api-v2/industry-data/utilities.pt.md new file mode 100644 index 0000000000..20e09652f9 --- /dev/null +++ b/guides/checkout-api-v2/industry-data/utilities.pt.md @@ -0,0 +1,112 @@ +# Utilities + +Estes são os dados específicos para a indústria de **utilities** que podem ser adicionados à sua integração para melhorar a aprovação dos pagamentos. + +## Campos para enviar + +Adicione qualquer informação extra que considerar necessária. + +### Sobre itens + +----[mla, mlm, mlu, mco, mlb, mpe]---- +| Array `items` | Tipo | Descrição | +| --- | --- | --- | +| `id` | String | Código de identificação do item. | +| `title` | String | Nome do item. | +| `category_id` | String | Categoria do item. | +| `quantity` | Integer | Quantidade de unidades do item. | +| `unit_price` | Float | Preço unitário atribuído ao item. Pode ser um valor inteiro ou em casas decimais. | +------------ + +----[mlc]---- +| Array `items` | Tipo | Descrição | +| --- | --- | --- | +| `id` | String | Código de identificação do item. | +| `title` | String | Nome do item. | +| `category_id` | String | Categoria do item. | +| `quantity` | Integer | Quantidade de unidades do item. | +| `unit_price` | Float | Preço unitário atribuído ao item. Deve ser um valor inteiro. | +------------ + +### Sobre o comprador + +| Object `payer` | Tipo | Descrição | +| --- | --- | --- | +| `first_name` | String | Nome do comprador. | +| `last_name` | String | Sobrenome do comprador. | +| `identification` | Object | Dados de identificação do comprador. | +| `type` | String | Tipo de identificação. Está dentro do objeto `identification`. | +| `number` | String | Número de identificação. Está dentro do objeto `identification`. | +| `phone` | Object | Telefone do comprador. | +| `area_code` | Integer | Código de área do comprador. Está dentro do objeto `phone`. | +| `number` | Integer | Número de telefone do comprador. Está dentro do objeto `phone`. | +| `address` | Object | Dados do endereço do comprador. | +| `zip_code` | String | Código postal do comprador. Está dentro do objeto `address`. | +| `street_name` | String | Nome da rua do endereço do comprador. Está dentro do objeto `address`. | +| `street_number` | Integer | Número da rua do endereço do comprador. Está dentro do objeto `address`. | +| `authentication_type` | Enum | Tipo de autenticação. Pode ser "Gmail", "Facebook", "Web Nativa" ou "Outro". | +| `registration_date` | Date | Data de registro do comprador no site. | +| `is_prime_user` | Boolean | Indica se o usuário é *premium*. Caso seja, use `true` e, caso não seja, use `false`. | +| `is_first_purchase_online` | Boolean | Indica se é a primeira compra do cliente. Caso seja, use `true` e, caso não seja, use `false`. | +| `last_purchase` | Date | Data da última compra no site. | + +```curl +curl --location 'https://api.mercadopago.com/v1/payments' \ +--header 'Content-Type: application/json' \ +--header 'X-Idempotency-Key: {{uuid}}' \ +--header 'Authorization: Bearer ACCESS_TOKEN' \ +--header 'X-Meli-Session-Id: {{device_id}} \ +--data-raw '{ + "transaction_amount": 150.00, + "installments": 1, + "statement_descriptor": "LOJA 123", + "capture": true, + "binary_mode": false, + "sponsor_id": null, + "application_fee": null, + "payment_method_id": "debvisa", + "token": "{{card_token_id}}", + "external_reference": "Pedido01", + "description": "PEDIDO NOVO", + "notification_url": "{{notification_url}}", + "metadata": { + "order_number": "order_01" + }, + "payer": { + "email": "test_user_123456789@testuser.com", + "identification": { + "type": "CPF", + "number": "12345678909" + } + }, + "additional_info": { + "items": [ + { + "id": "1234", + "title": "Serviço", + "category_id": "service", + "quantity": 1, + "unit_price": 150 + } + ], + "payer": { + "first_name": "Nome", + "last_name": "Sobrenome", + "is_prime_user": "1", + "is_first_purchase_online": "1", + "last_purchase": "2019-10-25T19:30:00.000-03:00", + "phone": { + "area_code": "11", + "number": "987654321" + }, + "address": { + "zip_code": "206233-2002", + "street_name": "Av. das Nações Unidas", + "street_number": "3003" + }, + "authentication_type": "Facebook", + "registration_date": "2020-08-06T09:25:04.000-03:00" + } + } +}' +``` \ No newline at end of file