Merge pull request #2254 from mercadopago/fix/qr-basics

fix/qr-basics

guides/additional-content/getting-started/getting-started.en.md

@@ -2,8 +2,6 @@
 
 Mercado Pago offers several solutions that allow you to receive virtual or in-person payments. You can provide payment methods without contracts or monthly fees, through integrations with online stores or products, such as a payment link, QR Code, and the Mercado Pago machine, the Point, which may or may not be integrated.
 
-> **Do you already know the advantages of each product?** Check out [here](https://www.mercadopago[FAKER][URL][DOMAIN]/ferramentas-para-vender?gclid=CjwKCAiAx8KQBhAGEiwAD3EiP9TeLRYVwHhVkKajMvy7LONL7t49Q0pSjdly3TNkOLrileJdl5lHSBoCUcAQAvD_BwE&matt_tool=79642323&utm_experiment=optimize&matt_word=MLB_MP_G_AO_OP_COW_BRAND_SELL_CONV_TRANPARENTE#from=public_navigation), get to know all features in-depth, and find the best solution for your business. 
-
 In the case of integrable solutions, the initial integration flow is always the same: the first step is to have a Mercado Pago account, as this is where the sale payments will be sent. 
 
 > NOTE

guides/additional-content/getting-started/getting-started.es.md

@@ -2,8 +2,6 @@
 
 Mercado Pago ofrece varias soluciones que te permiten recibir pagos virtuales o presenciales. Puedes brindar medios de pago sin contratos ni cuotas mensuales, a través de integraciones con tiendas en línea o productos, tales como link de pago, Código QR, y la máquina de Mercado Pago, el Point, que pueden o no estar integrados.
 
-> **¿Ya conoces las ventajas de cada producto?** Echa un vistazo [aquí](https://www.mercadopago[FAKER][URL][DOMAIN]/ferramentas-para-vender?gclid=CjwKCAiAx8KQBhAGEiwAD3EiP9TeLRYVwHhVkKajMvy7LONL7t49Q0pSjdly3TNkOLrileJdl5lHSBoCUcAQAvD_BwE&matt_tool=79642323&utm_experiment=optimize&matt_word=MLB_MP_G_AO_OP_COW_BRAND_SELL_CONV_TRANPARENTE#from=public_navigation), conoce todas las funciones en profundidad y encuentra la mejor solución para tu negocio.
-
 En el caso de las soluciones integrables, el flujo de integración inicial es siempre el mismo: el primer paso es tener una cuenta de Mercado Pago, ya que es allí donde se enviarán los pagos de las ventas.
 
 > NOTE

guides/additional-content/getting-started/getting-started.pt.md

@@ -2,8 +2,6 @@
 
 O Mercado Pago oferece diversas soluções que permitem receber pagamentos virtuais ou presenciais. Você pode oferecer meios de pagamento sem contratos nem mensalidades, através de integrações em loja online ou produtos, como link de pagamento, Código QR e com Point, a maquininha do Mercado Pago, que podem ou não ser integrados.
 
-> **Você já conhece as vantagens de cada produto?** Dê uma olhada [aqui](https://www.mercadopago[FAKER][URL][DOMAIN]/ferramentas-para-vender?gclid=CjwKCAiAx8KQBhAGEiwAD3EiP9TeLRYVwHhVkKajMvy7LONL7t49Q0pSjdly3TNkOLrileJdl5lHSBoCUcAQAvD_BwE&matt_tool=79642323&utm_experiment=optimize&matt_word=MLB_MP_G_AO_OP_COW_BRAND_SELL_CONV_TRANPARENTE#from=public_navigation), conheça a fundo todas as suas funcionalidades e saiba qual a melhor solução para o negócio.
-
 No caso das soluções integráveis, o fluxo inicial de integração é sempre o mesmo: o primeiro passo para integrar é ter uma conta Mercado Pago, pois é nela que serão recebidos os pagamentos das vendas. 
 
 > NOTE

guides/qr-code/glossary.en.md

@@ -4,9 +4,9 @@ We know some concepts may be new for you. Before starting, here's a cheatsheet.
 
 | Term | Description |
 | --- | --- |
-| Credentials | Your credentials are the keys we give you so you can set up your integrations. To find them, go to your [credentials]([FAKER][CREDENTIALS][URL]) and select the productive ones. |
-| `ACCESS_TOKEN` | The private app key to generate payments. You'll find it on the [credentials]([FAKER][CREDENTIALS][URL]) section. You must use it to identify yourself in your integrations. Always use the Production Mode credentials. |
-| `USER_ID` | Buyer's user ID in Mercado Pago, consists of the last digits on the `access_token`, after the last dash. So, for instance, if your `access_token` is **APP_USR-8499883828799661-062409-bf057c51fc05f87eba5608328f869879-446566691**, then your `USER_ID` is **446566691**. Also known as the `COLLECTOR_ID`. |
+| Credentials | Your credentials are the keys we give you so you can set up your integrations. To find them, go to your [credentials](/developers/es/docs/qr-code/additional-content/your-integrations/credentials) and select the productive ones. |
+| `ACCESS_TOKEN` | The private app key to generate payments. You'll find it on the [credentials](/developers/en/docs/qr-code/additional-content/your-integrations/credentials) section. You must use it to identify yourself in your integrations. Always use the Production Mode credentials. |
+| `USER_ID` | Buyer's user ID in Mercado Pago. You'll find it on the [your application details](/developers/en/docs/qr-code/additional-content/your-integrations/application-details). It's also known as the `COLLECTOR_ID`. |
 | `SPONSOR_ID` | Supplier's ID on the integrated system with Mercado Pago. Consist of the last digits of the `access_token`, after the last dash. So, for instance, if your `access_token` is **APP_USR-8499883828799661-062409-bf057c51fc05f87eba5608328f869879-776566693**, then your `USER_ID` is **776566693**. `sponsor_ID` must be different than `USER_ID`. |
 | Store | A **physical shop** in which your clients can get products and services. You can have multiple stores on one account. |
 | Point of sale (POS) | A **place to perform a transaction** on a store or physical shop. Each POS will be linked with a unique QR code. |

guides/qr-code/glossary.es.md

@@ -4,10 +4,10 @@ Sabemos que algunos términos son nuevos. Antes de empezar, te los dejamos a man
 
 | Término | Descripción |
 | --- | --- |
-| Credenciales (Credentials) | Tus credenciales son las claves que te proporcionamos para que puedas configurar tus integraciones. Para poder encontrarlas, ve a tus [credenciales]([FAKER][CREDENTIALS][URL]) y selecciona las productivas. |
-| `ACCESS_TOKEN` | Es la clave privada de la aplicación para generar pagos, dentro de la sección [credenciales]([FAKER][CREDENTIALS][URL]). Debes usarla para identificarte en tus integraciones. Siempre usa las del Modo Producción. |
-| `USER_ID` | ID de la cuenta de Mercado Pago. Se compone por los últimos dígitos del `access_token` posteriores al último guión medio. Entonces, por ejemplo, si tu `access_token` es **APP_USR-8499883828799661-062409-bf057c51fc05f87eba5608328f869879-446566691**, entonces tu `USER_ID` es **446566691**. También lo puedes encontrar como _`COLLECTOR_ID`_. |
+| Credenciales (Credentials) | Tus credenciales son las claves que te proporcionamos para que puedas configurar tus integraciones. Para poder encontrarlas, ve a tus [credenciales](/developers/es/docs/qr-code/additional-content/your-integrations/credentials) y selecciona las productivas. |
+| `ACCESS_TOKEN` | Es la clave privada de la aplicación para generar pagos, dentro de la sección [credenciales](/developers/es/docs/qr-code/additional-content/your-integrations/credentials). Debes usarla para identificarte en tus integraciones. Siempre usa las del Modo Producción. |
+| `USER_ID` | ID de la cuenta de Mercado Pago. Puedes consultarlo en los [detalles de la aplicación](/developers/es/docs/qr-code/additional-content/your-integrations/application-details). También lo puedes encontrar como _`COLLECTOR_ID`_. |
 | `SPONSOR_ID` | Es el `USER_ID` del usuario proveedor del sistema integrado con Mercado Pago. Se compone por los últimos dígitos del `access_token` posteriores al último guión medio. Entonces, por ejemplo, si tu `access_token` es **APP_USR-8499883828799661-062409-bf057c51fc05f87eba5608328f869879-776566693**, entonces tu `USER_ID` es **776566693**.  El `SPONSOR_ID` no puede ser igual al `USER_ID`. |
 | Sucursal (Store) | Es una **tienda física** en la que tus clientes pueden adquirir tus productos o servicios. Puedes tener varias sucursales en una misma cuenta. |
-| Caja (POS) | Es un **punto de venta** que existe en una sucursal o tienda física. Cada caja tendrá vinculado un código QR unívoco. |
+| Caja (POS) | Es un **Punto de Venta (PDV)** que existe en una sucursal o tienda física. Cada caja tendrá vinculado un código QR unívoco. |
 | Orden | Es el pedido realizado por tu cliente. Contiene un listado de productos con su monto asociado. |

guides/qr-code/glossary.pt.md

@@ -4,10 +4,10 @@ Sabemos que alguns termos são novos. Antes de começar, os deixamos perto de su
 
 | Termo | Descrição |
 | --- | --- |
-| Credenciais (Credentials) | Suas credenciais são as senhas que lhe fornecemos para que você possa configurar suas integrações. Para poder achá-las, vá para suas [credenciais]([FAKER][CREDENTIALS][URL]) e selecione as produtivas. |
-| `ACCESS_TOKEN` | É a senha privada do aplicativo para gerar pagamentos, dentro da secção [credenciais]([FAKER][CREDENTIALS][URL]). Deve utilizá-la para se identificar em suas integrações. Utiliza sempre as do **Modo Produção**. |
-| `USER_ID` | É o ID do usuário vendedor no Mercado Pago. Este ID é composto pelos últimos dígitos do access_token após o último hífen. Isso significa que, se o seu `access_token` for **APP_USR-8499883828799661-062409-bf057c51fc05f87eba5608328f869879-446566691**, seu `USER_ID` será **446566691**. Também conhecido como `COLLECTOR_ID`. |
+| Credenciais (Credentials) | Suas credenciais são as senhas que lhe fornecemos para que você possa configurar suas integrações. Para poder achá-las, vá para suas [credenciais](/developers/pt/docs/qr-code/additional-content/your-integrations/credentials) e selecione as produtivas. |
+| `ACCESS_TOKEN` | É a senha privada do aplicativo para gerar pagamentos, dentro da secção [credenciais](/developers/pt/docs/qr-code/additional-content/your-integrations/credentials). Deve utilizá-la para se identificar em suas integrações. Utiliza sempre as do **Modo Produção**. |
+| `USER_ID` | É o ID do usuário vendedor no Mercado Pago. Consulte-o nos [detalhes da aplicação](/developers/pt/docs/qr-code/additional-content/your-integrations/application-details). É também conhecido como `COLLECTOR_ID`. |
 | `SPONSOR_ID` | É o ID do usuário fornecedor do sistema integrado com Mercado Pago. Este ID é composto pelos últimos dígitos do `access_token` após o último hífen. Isso significa que, se seu `access_token` for **APP_USR-8499883828799661-062409-bf057c51fc05f87eba5608328f869879-776566693**, seu `USER_ID` será **776566693**. O `sponsor_ID` não pode ser igual ao `USER_ID`. |
 | Loja (Store) | É uma **loja física** onde seus clientes podem adquirir seus produtos ou serviços. Você pode ter várias lojas numa mesma conta. |
-| Caixa (POS) | É um **ponto de venda** que existe numa sucursal ou loja física. Cada caixa terá um código QR unívoco vinculado. |
+| Caixa (POS) | É um **Ponto de Venda (PDV)** que existe em um quiosque ou loja física. Cada caixa terá um código QR unívoco vinculado. |
 | Ordem | É o pedido realizado pelo seu cliente. Contém uma relação de produtos com seu valor associado. |

guides/qr-code/introduction.en.md

@@ -16,7 +16,7 @@ Once you complete the integration as explained below, your business will be able
 
 | Type | Description |
 | --- | --- |
-| QR Attended Model | Integration model where the POS uses its system to post an order to a QR. The customer views and pays the order using the App.  |
-| QR Dynamic Model  | Integration model that generates a QR per transaction. Used for QR models in tickets.  |
+| QR Attended Model | Integration model where the POS uses its system to post a specific order to a QR. The customer views and pays the order using the App.  |
+| QR Dynamic Model  | Integration model that generates a QR per transaction, with the transaction amount included in it. Used for QR models in tickets.  |
 
 Depending on your business model, you can choose one of these options to offer your customers a seamless in-store shopping experience.

guides/qr-code/introduction.es.md

@@ -16,7 +16,7 @@ Una vez que hayas realizado la integración tal como te explicaremos aquí, podr
 
 | Tipo | Descripción |
 | --- | --- |
-| QR modelo atendido | Modelo de integración donde la caja publica una orden a un QR desde su propio sistema de punto de venta. El cliente ve la orden desde la App y realiza el pago. |
-| QR modelo dinámico | Modelo de integración donde se genera un QR por transacción. Usado para modelos de QR en ticket. |
+| QR modelo atendido | Modelo de integración donde el punto de venta utiliza su propio sistema para asignar al QR una orden específica. El cliente ve la orden desde la App y realiza el pago. |
+| QR modelo dinámico | Modelo de integración donde se genera un QR por transacción, con el monto ya incluido. Usado para modelos de QR en ticket. |
 
 En base a tu modelo de negocio, puedes escoger alguna de las opciones para ofrecer a tus clientes una buena experiencia de compra en tus tiendas físicas.

guides/qr-code/introduction.pt.md

@@ -16,7 +16,7 @@ Após completar a integração como explicado abaixo, o seu negócio poderá rec
 
 | Tipo | Descrição |
 | --- | --- |
-| QR Modelo Atendido | Modelo de integração onde o caixa envia um pedido a um QR desde seu próprio sistema de ponto de venda. O cliente vê o pedido e faz o pagamento pelo aplicativo. |
-| QR Modelo Dinâmico | Modelo de integração onde é gerado um QR por transação. Usado para modelos de QR em tickets. |
+| QR Modelo Atendido | Modelo de integração onde o ponto de venda atribui, desde seu próprio sistema, um pedido específico a um QR. O cliente vê o pedido e faz o pagamento pelo aplicativo. |
+| QR Modelo Dinâmico | Modelo de integração onde é gerado um QR por transação, com o valor já incluído. Usado para modelos de QR em tickets. |
 
 Em função do seu modelo de negócio, você pode escolher uma das opções para oferecer aos seus clientes uma ótima experiência de compra nas suas lojas físicas.

guides/qr-code/pre-requisites.en.md

@@ -22,34 +22,37 @@ You must create an application to obtain credentials and set up webhook notifica
 
 It's quite easy to do:
 
-1. Enter [Your integrations](https://www.mercadopago.com/developers/panel/applications).
-2. Select the **+** symbol in **Your applications** section to create a new application.
-3. Name the application to identify it later.
-4. Accept our Terms and Conditions. Done!
+1. Enter [Your integrations](https://www.mercadopago.com/developers/panel/app) and click on **Create application**.
+2. Name the application so you can identify it later.
+3. Select the option **In-person Payments** and then **QRCode**
+4. Optionally, you can select the integration mode, either **attended** or **dynamic**.
+5. Accept our Terms and Conditions, and then click on **Create application** again. Done!
 
 > NOTE
 >
 > Note
 >
->If your POS integrator has several tenants, see topic 4 and 5. Check your integration security and implement [OAuth.](/developers/es/docs/qr-code/additional-content/security/oauth/introduction)
+>If your Point of Sale (POS) integrator has several tenants, see topic 4 and 5 within this same section. Check your integration security and implement [OAuth.](/developers/es/docs/qr-code/additional-content/security/oauth/introduction)
 
 ## 3. Generate test users
 
 [TXTSNIPPET][/guides/snippets/test-integration/create-test-users]
 
+Once the test users are created, you can begin with your integration by creating a store and POS (Point of Sale).
+
 ## 4. Obtain your Access Token (OAuth)
 
 If you are an integrator that works with several retailers enabling them to operate with Mercado Pago, we recommend to perform the **OAuth - authentication between accounts** process. The process enables customers securely share personal data with a third-party system.
 
-The Access Token is not shareable in any way other than through OAuth.
+The Access Token is not shareable in any way other than through OAuth. You can learn more information about it reading our [documentation](/developers/es/docs/qr-code/additional-content/security/oauth/introduction).
 
 ## 5. Identify your integration (Sponsor ID)
 
-To identify the orders placed by your POS (Point Of Sale), include the Sponsor ID, and check the [in-store orders APIs](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/en/reference/instore_orders_v2/_instore_qr_seller_collectors_user_id_pos_external_pos_id_orders/get) on how to send this information.
+When a Mercado Pago account is created, it is assigned wiyh a User ID, if they are users, or a Cust ID, if they are a seller. Both are unique IDs that are automatically generated, and will allow the integrations to be associated with each account by including them in the API requests.
 
-Step by step:
+When you make integrations for third parties, the `sponsor_id` parameter will allow you to identify the orders that are placed by your point of sale.  You will have to send the Sponsor ID in the [in-store orders API](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/en/reference/instore_orders_v2/_instore_qr_seller_collectors_user_id_stores_external_store_id_pos_external_pos_id_orders/put) requests. Follow the instructions below to learn how to collect and send this information.
 
-> * Create an account on the Mercado Pago portal (Integrator ID).
-> * Obtain the user identification (Cust ID or User ID) of your account.
-> * Include the User ID of your integrator account in the seller's Sponsor ID.
-> * Submit the Sponsor ID on all QR transactions. [See API](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/en/reference/instore_orders/_mpmobile_instore_qr_user_id_external_id/post).
+1. If you haven't done so yet, create an account on the Mercado Pago portal.
+2. Obtain the user identification (Cust ID or User ID) of your account by accessing the [details of the application](/developers/en/docs/qr-code/additional-content/your-integrations/application-details) that you have created earlier.
+3. Include the User ID of your integrator account in the seller's Sponsor ID.
+4. Submit the Sponsor ID on all QR transactions, as shown in our [API Reference](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/en/reference/instore_orders/_mpmobile_instore_qr_user_id_external_id/post).