Merge pull request #2243 from mercadopago/feature/split-payment

Nova landing/agrupador de Split de Pagamentos

guides/additional-content/reports/released-money/api.en.md

@@ -35,7 +35,7 @@ You can configure your reports as needed. Below, we highlight the available API
 
 > Have the [Glossary of the Releases Report](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/en/guides/additional-content/reports/released-money/glossary) on hand for reference whenever needed or to check any technical terms.
 
-## Create a new configuration
+### Create a new configuration
 
 Customize your reports by assigning different creation properties by running the following _curl_:
 

guides/additional-content/reports/released-money/api.es.md

@@ -36,7 +36,7 @@ Puedes configurar tus reportes según sea necesario. A continuación, destacamos
 > Ten a mano el [Glossário del Reporte de ----[mla]---- Liquidações ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberações ------------](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/pt/guides/additional-content/reports/released-money/glossary) para consultarlo siempre que sea necesario o para verificar algún término técnico.
 
 
-## Crear una nueva configuración
+### Crear una nueva configuración
 
 Personaliza tus reportes asignando diferentes propiedades de creación ejecutando el siguiente _curl_:
 

guides/additional-content/reports/released-money/api.pt.md

@@ -35,7 +35,7 @@ Você pode configurar seus relatórios conforme necessário. Abaixo, destacamos
 
 > Tenha o [Glossário do relatório de ----[mla]---- Liquidações ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberações ------------](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/pt/guides/additional-content/reports/released-money/glossary) à mão para consulta sempre que necessário ou para conferir algum termo técnico.
 
-## Criar uma nova configuração
+### Criar uma nova configuração
 
 Personalize seus relatórios atribuindo diferentes propriedades de criação executando o seguinte _curl_: 
 

guides/marketplace/integrate-marketplace.en.md

@@ -4,10 +4,10 @@ Marketplace is an e-commerce site/platform that connects sellers and buyers in a
 
 In addition to the structure needed to make sales, some marketplaces take care of the arrangement of products, payment and shipping methods, optimizing the sales process and facilitating business management.
 
-If you choose to sell through a Marketplace, it is possible to integrate **two types of Mercado Pago checkout** to process payments made.
+If you choose to sell through a marketplace, it is possible to integrate **two types of Mercado Pago checkout** to process payments.
 
 * [Checkout Pro](/developers/en/guides/checkout-pro/landing): In this checkout model, the buyer is directed to a Mercado Pago page to complete the payment.
-* [Checkout API](/developers/en/guides/checkout-api/introduction): This checkout model allows the buyer to make the payment within the marketplace environment.
+* ----[mla, mlu, mpe, mco, mlc, mlm]----[Checkout API](/developers/en/guides/checkout-api/introduction)----------------[mlb]----[Checkout Transparente](/developers/en/guides/checkout-api/introduction)------------: This checkout model allows the buyer to make the payment within the marketplace environment.
 
 Both checkouts automatically split the amounts between the seller and the marketplace through the _split_ payment
 
@@ -17,14 +17,53 @@ Both checkouts automatically split the amounts between the seller and the market
 >
 > The Mercado Pago commission is deducted from the amount received by the seller. In other words, the Mercado Pago commission is deducted first and the Marketplace commission is deducted from the remaining amount.
 
-To perform the integration you will need to follow the usual integration flow of the chosen checkout necessarily using an access token for each seller, obtained through OAuth. Below we list the steps required to integrate a checkout with the marketplace.
+To perform the integration, you will need to follow the usual integration flow of the chosen checkout, necessarily using an access token for each seller, obtained through OAuth. Below we list the steps required to integrate a checkout with the marketplace.
 
 1. Follow the steps described in the [OAuth documentation](/developers/en/guides/additional-content/security/oauth/introduction) to get each `access_token`. This information will be needed during the checkout integration process into the marketplace.
-2. Choose the type of checkout you want ([Checkout Pro](/developers/en/guides/checkout-pro/landing) or [Checkout API](/developers/en/guides/checkout-api/introduction) and follow the entire onboarding flow.
-3. In the checkout integration, use the `public_key` of your integrator account in the frontend and insert the seller's `access_token` obtained in step 1, in the backend or in the request header.
+2. Choose the type of checkout you want ([Checkout Pro](/developers/en/guides/checkout-pro/landing) or ----[mla, mlu, mpe, mco, mlc, mlm]----[Checkout API](/developers/en/guides/checkout-api/introduction)----------------[mlb]----[Checkout Transparente](/developers/en/guides/checkout-api/introduction)------------) and follow the entire onboarding flow.
+3. In the checkout integration, use the `public_key` of your integrator account in the frontend and insert the seller's `access_token` (obtained in step 1) in the backend or in the request header.
 4. To determine the marketplace commission percentage:
 
-    - If the checkout is Pro, fill the `marketplace_fee` parameter with the amount to be charged for each payment preference created in the **/checkout/preferences** API.
-    - If the checkout is API, fill the `application_fee` parameter with the amount to be charged for each payment created in the **/payments** API.
+  - If it's Checkout Pro, fill the `marketplace_fee` parameter with the amount to be charged for each payment preference created in the **/checkout/preferences** API.
 
-Upon completing these steps, the checkout will have been integrated into the marketplace and will be ready to process payments.
+<br>
+
+#### Example
+
+```json
+    {
+    "items": [
+        {
+            "id": "item-ID-1234",
+            "title": "Meu produto",
+            "currency_id": "BRL",
+            "quantity": 1,
+            "unit_price": 75.76
+        }
+    ],
+    "marketplace_fee": 10
+    }
+```
+
+  - If it's Checkout ----[mla, mlu, mpe, mco, mlc, mlm]----API------------ ----[mlb]----Transparente------------, fill the `application_fee` parameter with the amount to be charged for each payment created in the **/payments** API.
+
+<br>
+
+#### Example
+
+```json
+    {
+    "description": "API TRANSPARENTE MARKETPLACE",
+    "installments": 1,
+    "token": "{{card_token}}",
+    "payer": {
+        "id": "{{payer_id}}"
+    },
+    "marketplace": "{{marketplace_id}}",
+    "payment_method_id": "master",
+    "application_fee": 2,
+    "transaction_amount": 10
+    }
+```
+
+Upon completing these steps, the checkout will have been integrated into the marketplace and will be ready to process payments.

guides/marketplace/integrate-marketplace.es.md

@@ -6,26 +6,64 @@ Además de la estructura necesaria para realizar las ventas, algunos _marketplac
 
 Si eliges vender a través de un _marketplace_, es posible integrar **dos tipos de checkout de Mercado Pago** para procesar los pagos realizados.
 
-
-* [Checkout Pro](/developers/es/guides/checkout-pro/landing):  en este modelo de checkout, el comprador es dirigido a una página de Mercado Pago para completar el pago.
-* ----[mla, mlu, mpe, mco, mlc, mlm]----[Checkout API](/developers/es/guides/checkout-api/introduction)------------ ----[mlb]----[Checkout Transparente](/developers/es/guides/checkout-api/introduction)------------: este modelo de pago permite al comprador realizar el pago dentro del entorno del _marketplace_.
+* [Checkout Pro](/developers/es/guides/checkout-pro/landing): en este modelo de checkout, el comprador es dirigido a una página de Mercado Pago para completar el pago.
+* ----[mla, mlu, mpe, mco, mlc, mlm]----[Checkout API](/developers/es/guides/checkout-api/introduction)----------------[mlb]----[Checkout Transparente](/developers/es/guides/checkout-api/introduction)------------: este modelo de pago permite al comprador realizar el pago dentro del entorno del _marketplace_.
 
 Ambos checkouts reparten automáticamente los importes entre el vendedor y el _marketplace_ a través del _split del pago_ sin necesidad de ninguna acción por parte del vendedor.
 
 > NOTE
 >
 > Importante
 >
-> La comisión de Mercado Pago se descuenta de los fondos recibidos por el vendedor. Es decir, primero se descuenta la comisión de Mercado Pago y la comisión del marketplace se descuenta del saldo restante.
+> La comisión de Mercado Pago se descuenta de los fondos recibidos por el vendedor. Es decir, primero se descuenta la comisión de Mercado Pago, y la comisión del marketplace se descuenta del saldo restante.
 
-Para realizar la integración deberás seguir el flujo de integración habitual del _checkout_ elegido, utilizando necesariamente un token de acceso para cada vendedor, obtenido a través de OAuth. A continuación, enumeramos los pasos necesarios para integrar una caja con el _mercado_.
+Para realizar la integración deberás seguir el flujo de integración habitual del _checkout_ elegido, utilizando necesariamente el token de acceso para cada vendedor que fue obtenido a través de OAuth. A continuación, enumeramos los pasos necesarios para integrar una caja con el _marketplace_.
 
 1. Sigue los pasos descritos en la [documentación de OAuth](/developers/es/guides/additional-content/security/oauth/introduction) para obtener cada `access_token`. Esta información será necesaria durante el proceso de integración de pago en el _marketplace_.
-2. Elige el tipo de pago que desea ([Checkout Pro](/developers/es/guides/checkout-pro/landing) o ----[mla, mlu, mpe, mco, mlc, mlm]----[Checkout API](/developers/es/guides/checkout-api/introduction)------------ ----[mlb]----[Checkout Transparente](/developers/es/guides/checkout-api/introduction)------------) y sigue todo el flujo de integración.
-3. En la integración del _checkout_, usa la `public_key` de tu cuenta de integrador en el frontend e inserta el `access_token` del vendedor obtenido en el paso 1, en el backend o en el _header_ de la solicitud.
-4. Para determinar el porcentaje de comisión del mercado:
+2. Elige el checkout que deseas ([Checkout Pro](/developers/es/guides/checkout-pro/landing) o ----[mla, mlu, mpe, mco, mlc, mlm]----[Checkout API](/developers/es/guides/checkout-api/introduction)------------ ----[mlb]----[Checkout Transparente](/developers/es/guides/checkout-api/introduction)------------) y sigue todo el flujo de integración.
+3. En la integración del _checkout_, usa la `public_key` de tu cuenta de integrador en el _frontend_ e inserta el `access_token` del vendedor (obtenido en el paso 1) en el _backend_ o en el _header_ de la solicitud.
+4. Para determinar el porcentaje de comisión del marketplace:
+
+  - Si es Checkout Pro, completa el parámetro `marketplace_fee` con el monto que se cobrará por cada preferencia de pago creada en la API **/checkout/preferences**.
+
+<br>
+
+#### Ejemplo
+
+```json
+    {
+    "items": [
+        {
+            "id": "item-ID-1234",
+            "title": "Meu produto",
+            "currency_id": "BRL",
+            "quantity": 1,
+            "unit_price": 75.76
+        }
+    ],
+    "marketplace_fee": 10
+    }
+```
+
+  - Si es Checkout ----[mla, mlu, mpe, mco, mlc, mlm]----API------------ ----[mlb]----Transparente------------, completa el parámetro `application_fee` con el monto que se cobrará por cada pago creado en la API **/payments**.
+
+<br>
+
+#### Ejemplo
 
-    - Si el checkout es Pro, completa el parámetro `marketplace_fee` con el monto que se cobrará por cada preferencia de pago creada en la API **/checkout/preferences**.
-    - Si el checkout es transparente, completa el parámetro `application_fee` con el monto que se cobrará por cada pago creado en la API **/payments**.
+```json
+    {
+    "description": "API TRANSPARENTE MARKETPLACE",
+    "installments": 1,
+    "token": "{{card_token}}",
+    "payer": {
+        "id": "{{payer_id}}"
+    },
+    "marketplace": "{{marketplace_id}}",
+    "payment_method_id": "master",
+    "application_fee": 2,
+    "transaction_amount": 10
+    }
+```
 
-Al completar estos pasos, el pago se habrá integrado en el _marketplace_ y estará listo para procesar pagos.
+Al completar estos pasos, el checkout se habrá integrado en el _marketplace_ y estará listo para procesar pagos.

guides/marketplace/integrate-marketplace.pt.md

@@ -4,28 +4,66 @@ Marketplace é um site/plataforma de e-commerce que conecta vendedores e comprad
 
 Além da estrutura necessária para realizar vendas, alguns _marketplaces_ cuidam da disposição dos produtos, métodos de pagamento e envio, otimizando o processo de venda e facilitando o gerenciamento do negócio.
 
-Caso escolha vender através de um Marketplace, é possível integrar **dois tipos de checkout do Mercado Pago** para processar os pagamentos realizados.
+Caso escolha vender através de um _marketplace_, é possível integrar **dois tipos de checkout do Mercado Pago** para processar os pagamentos realizados.
 
-* [Checkout Pro](/developers/pt/guides/checkout-pro/landing):  Neste modelo de checkout  o comprador é direcionado para uma página do Mercado Pago para concluir o pagamento.
-* ----[mla, mlu, mpe, mco, mlc, mlm]----[Checkout API](/developers/pt/guides/checkout-api/introduction)------------ ----[mlb]----[Checkout Transparente](/developers/pt/guides/checkout-api/introduction)------------: Este modelo de checkout permite ao comprador realizar o pagamento dentro do ambiente do _marketplace_.
+* [Checkout Pro](/developers/pt/guides/checkout-pro/landing): Neste modelo de checkout, o comprador é direcionado para uma página do Mercado Pago para concluir o pagamento.
+* ----[mla, mlu, mpe, mco, mlc, mlm]----[Checkout API](/developers/pt/guides/checkout-api/introduction)----------------[mlb]----[Checkout Transparente](/developers/pt/guides/checkout-api/introduction)------------: Este modelo de checkout permite ao comprador realizar o pagamento dentro do ambiente do _marketplace_.
 
-Ambos checkouts realizam automaticamente a divisão dos valores entre o vendedor e o _marketplace_ por meio do _split_ de pagamento, sem a necessidade de qualquer ação por parte do vendedor.
+Ambos os checkouts realizam automaticamente a divisão dos valores entre o vendedor e o _marketplace_ por meio do _split_ de pagamento, sem a necessidade de qualquer ação por parte do vendedor.
 
 > NOTE
 >
 > Importante
 >
-> A comissão do Mercado Pago é descontada do valor recebido pelo vendedor. Ou seja,  primeiro é descontada a comissão do Mercado Pago e sobre o valor restante se desconta a comissão do Marketplace.
+> A comissão do Mercado Pago é descontada do valor recebido pelo vendedor. Ou seja, primeiro, a comissão do Mercado Pago é descontada e, em seguida, a comissão do Marketplace é descontada sobre o valor restante.
 
-Para realizar a integração você precisará seguir o fluxo de integração usual do checkout escolhido necessariamente usando um access token para cada vendedor, obtido através de OAuth. Abaixo listamos as etapas necessárias para integrar um checkout ao _marketplace_.
+Para realizar a integração você precisará seguir o fluxo de integração usual do checkout escolhido utilizando um _access token_ para cada vendedor, obtido através de OAuth. Abaixo, listamos as etapas necessárias para integrar um checkout ao _marketplace_.
 
 1. Siga as etapas descritas na [documentação OAuth](/developers/pt/guides/additional-content/security/oauth/introduction) para obter cada `access_token`. Esta informação será necessária durante o processo de integração do checkout ao _marketplace_.
-2. Escolha o tipo de checkout que deseja ([Checkout Pro](/developers/pt/guides/checkout-pro/landing) ou ----[mla, mlu, mpe, mco, mlc, mlm]----[Checkout API](/developers/pt/guides/checkout-api/introduction------------ ----[mlb]----[Checkout Transparente](/developers/pt/guides/checkout-api/introduction)------------) e siga todo o fluxo de integração.
-3. Na integração do checkout, utilize a `public_key` da sua conta de integrador no frontend e insira o `access_token` do vendedor obtido na etapa 1, no backend ou no header da requisição. 
-
+2. Escolha o tipo de checkout ([Checkout Pro](/developers/pt/guides/checkout-pro/landing) ou ----[mla, mlu, mpe, mco, mlc, mlm]----[Checkout API](/developers/pt/guides/checkout-api/introduction------------ ----[mlb]----[Checkout Transparente](/developers/pt/guides/checkout-api/introduction)------------)) e siga o fluxo de integração.
+3. Na integração do checkout, utilize a `public_key` da sua conta de integrador no _frontend_ e insira o `access_token` do vendedor (obtido na etapa 1) no _backend_ ou no _header_ da requisição. 
 4. Para determinar a porcentagem de comissão do marketplace:
 
-    - Se o checkout for Pro, preencha o parâmetro `marketplace_fee` com o valor a ser cobrado para cada preferência de pagamento criada na API **/checkout/preferences**.
-    - Se o checkout for Transparente, preencha o parâmetro `application_fee` com o valor a ser cobrado para cada pagamento criado na API **/payments**.
+  - Se o checkout for Pro, preencha o parâmetro `marketplace_fee` com o valor a ser cobrado para cada preferência de pagamento criada na API **/checkout/preferences**.
+
+<br>
+
+#### Exemplo
+
+```json
+    {
+    "items": [
+        {
+            "id": "item-ID-1234",
+            "title": "Meu produto",
+            "currency_id": "BRL",
+            "quantity": 1,
+            "unit_price": 75.76
+        }
+    ],
+    "marketplace_fee": 10
+    }
+```
+
+  - Se o checkout for ----[mla, mlu, mpe, mco, mlc, mlm]----API------------ ----[mlb]----Transparente------------, preencha o parâmetro `application_fee` com o valor a ser cobrado para cada pagamento criado na API **/payments**.
+
+<br>
+
+#### Exemplo
+
+```json
+    {
+    "description": "API TRANSPARENTE MARKETPLACE",
+    "installments": 1,
+    "token": "{{card_token}}",
+    "payer": {
+        "id": "{{payer_id}}"
+    },
+    "marketplace": "{{marketplace_id}}",
+    "payment_method_id": "master",
+    "application_fee": 2,
+    "transaction_amount": 10
+    }
+```
 
-Ao concluir essas etapas, o checkout terá sido integrado ao _marketplace_ e estará pronto para processar os pagamentos.
+Ao finalizar essas etapas, a integração do checkout com o _marketplace_ estará concluída e pronta para processar os pagamentos.