Skip to content

Commit

Permalink
Merge pull request #2289 from mercadopago/feature/plugins-testing-doc…
Browse files Browse the repository at this point in the history
…umentation

Documentação de teste dos plugins
  • Loading branch information
hgaldino authored Mar 1, 2024
2 parents 2e7bc17 + 613bcd5 commit 68d5533
Show file tree
Hide file tree
Showing 52 changed files with 729 additions and 268 deletions.
56 changes: 56 additions & 0 deletions guides/adobe-commerce/integration-test.en.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,56 @@
# Test payments

Purchase tests are essential to ensure that payments are processed correctly before authorizing real transactions. To verify that your store is set up correctly, we recommend testing payments before launching it in production.

> WARNING
>
> Important
>
> Testing can only be performed after the [integration configuration.](/developers/en/docs/adobe-commerce/integration-configuration)
Here's how to test the integration:
1. Access **[Your integrations](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/panel/app)** in the Mercado Pago admin and select the application you want to test.
2. Click on **Test Accounts** in the left menu.
3. Within the **Test Accounts** section, click on **Create test account** and create two different accounts: one for the seller and another for the buyer. It is not possible to use the same test account for both roles. Refer to the [Test accounts documentation](/developers/en/docs/adobe-commerce/additional-content/your-integrations/test/accounts) for a step-by-step guide on creating test accounts.

<center>

![Create Account](/images/adobe-commerce/test-create-account-es.gif)

</center>

4. Open a new incognito window and log in to Mercado Pago using the seller's test account created in the previous step.
5. In the same incognito window logged in as the seller, access the [Developer dashboard](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/panel/app) and create a new application, following the detailed instructions in the [Developer dashboard documentation.](/developers/en/docs/adobe-commerce/additional-content/your-integrations/dashboard)

![Login](/images/adobe-commerce/test-login-esp.gif)

6. Access the application created in the previous step and click on **Production credentials** in the left menu. Copy the `access_token` and `public_key`.

![Production credentials](/images/adobe-commerce/test-prod-credentials-es.png)

7. Go to the settings of the Adobe Commerce panel (**Stores > Configuration > Sales > Payment Methods > Other payment methods > Configure > Basic Settings > Mercado Pago Integration**).
8. Select the **Production** option in the "Checkout operation mode" field.
9. Enter the production credentials `access_token` and `public_key` of the seller's test account.

![Panel](/images/adobe-commerce/test-adobe-commerce.png)

11. Click on **Save Config**.
12. Open a new incognito window and log in to Mercado Pago using the buyer's test account created in step 3.
----[mlb]----
13. In the same window logged in as a buyer, access your store and make a purchase by providing test information such as CPF, RG, phone, and email from the buyer's test account. Also, use the test cards available in the [documentation](/developers/en/docs/adobe-commerce/additional-content/your-integrations/test/cards) corresponding.

------------
----[mla, mpe, mco, mlm, mco, mlu, mlc]----
13. In the same window logged in as a buyer, access your store and make a purchase by providing test information such as phone and email from the buyer's test account. In the "Documento" field, select the option **OTRO** and enter 9 digits. Also, use the test cards available in the [documentation](/developers/en/docs/adobe-commerce/additional-content/your-integrations/test/cards) corresponding.

------------

> WARNING
>
> Important
>
> During testing, you will be operating in the production environment. However, this is a test in which you will be using fictional credentials to simulate real scenarios. After completing the tests, remember to replace the seller's credentials (both production and test), entered in the plugin panel in step 9, with the real credentials from your Mercado Pago account. This action will allow you to continue selling in your store and avoid confusion.
After completing a test purchase using either Checkout Pro or Checkout----[mlb]---- Transparente------------ ----[mla, mpe, mco, mlm, mco, mlu, mlc]----API------------, the approval of the purchase will be visible in the Adobe Administrative Panel, except for purchases made through offline methods----[mlb]---- and Pix------------, which will remain in pending status.

Additionally, the orders will be recorded in the order history of the Mercado Pago seller's test account.
56 changes: 56 additions & 0 deletions guides/adobe-commerce/integration-test.es.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,56 @@
# Probar pagos

Las pruebas de compras son esenciales para asegurar que los pagos se procesen correctamente antes de autorizar transacciones reales. Para verificar que tu tienda esté configurada correctamente, te recomendamos que realices pruebas de pago antes de ponerla en producción.

> WARNING
>
> Importante
>
> La prueba solo se puede realizar después de la etapa de [configuración de la integración.](/developers/es/docs/adobe-commerce/integration-configuration)
A continuación, te indicamos cómo probar la integración:
1. Accede a **[Tus integraciones](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/panel/app)** en el administrador de Mercado Pago y selecciona la aplicación que deseas probar.
2. Haz clic en **Cuentas de prueba** en el menú de la izquierda.
3. Dentro de la sección de **Cuentas de prueba**, haz clic en **Crear cuenta de prueba** y crea dos cuentas diferentes: una para el vendedor y otra para el comprador. No es posible utilizar la misma cuenta de prueba para el vendedor y el comprador. Consulta la [documentación de Cuentas de prueba](/developers/es/docs/adobe-commerce/additional-content/your-integrations/test/accounts) para acceder al paso a paso de creación de cuentas de prueba.

<center>

![Crear cuenta](/images/adobe-commerce/test-create-account-es.gif)

</center>

4. Abre una nueva ventana de incógnito e inicia sesión en Mercado Pago usando la cuenta de prueba del vendedor creada en el paso anterior.
5. En la misma ventana de incógnito iniciada como vendedor, accede al [Panel del desarrollador](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/panel/app) y crea una nueva aplicación siguiendo las instrucciones detalladas en la [documentación del Panel del desarrollador.](/developers/es/docs/adobe-commerce/additional-content/your-integrations/dashboard)

![Iniciar sesión](/images/adobe-commerce/test-login-esp.gif)

6. Accede a la aplicación creada en el paso anterior y haz clic en **Credenciales de producción** en el menú de la izquierda. Copia el `access_token` y la `public_key`.

![Credenciales de producción](/images/adobe-commerce/test-prod-credentials-es.png)

7. Ve a la configuración del panel de Adobe Commerce (**Tiendas > Configuración > Ventas > Métodos de pago > Otros métodos de pago > Configurar > Configuración básica > Integración Mercado Pago**).
8. Selecciona la opción **Producción** en el campo "Modo de operación de pago".
9. Ingresa las credenciales de producción `access_token` y `public_key` de la cuenta de prueba del vendedor.

![Panel](/images/adobe-commerce/test-adobe-commerce.png)

11. Haz clic en **Guardar configuración**.
12. Abre una nueva ventana de incógnito e inicia sesión en Mercado Pago usando la cuenta de prueba del comprador creada en el paso 3.
----[mlb]----
13. En la misma ventana iniciada como comprador, accede a tu tienda y realiza una compra proporcionando información de prueba, como CPF, RG, número de teléfono y correo electrónico de la cuenta de prueba del comprador. Utiliza también las tarjetas de prueba disponibles en la [documentación](/developers/es/docs/adobe-commerce/additional-content/your-integrations/test/cards) correspondiente.

------------
----[mla, mpe, mco, mlm, mco, mlu, mlc]----
13. En la misma ventana iniciada sesión como comprador, accede a tu tienda y realiza una compra proporcionando información de prueba, como el teléfono y el correo electrónico de la cuenta de prueba del comprador. En "Documento", selecciona la opción **OTRO** e ingresa 9 dígitos. Utiliza también las tarjetas de prueba disponibles en la [documentación](/developers/es/docs/adobe-commerce/additional-content/your-integrations/test/cards) correspondiente.

------------

> WARNING
>
> Importante
>
> Durante las pruebas, estarás operando en el entorno de producción; sin embargo, se trata de una prueba en la que utilizarás credenciales ficticias para simular escenarios reales. Al concluir las pruebas, recuerda reemplazar las credenciales del vendedor (tanto de producción como de prueba) ingresadas en el panel del complemento en el paso 9, por las credenciales reales de tu cuenta en Mercado Pago. Esta acción te permitirá seguir vendiendo en tu tienda y evitará confusiones.
Después de completar una compra de prueba utilizando Checkout Pro o Checkout----[mlb]---- Transparente------------ ----[mla, mpe, mco, mlm, mco, mlu, mlc]----API------------, la aprobación de la compra será visible en el Panel Administrativo de Adobe, con excepción de las compras realizadas mediante métodos offline----[mlb]---- y Pix------------, que permanecerán con estado pendiente.

Además, los pedidos se registrarán en el historial de la cuenta de prueba del vendedor de Mercado Pago.
53 changes: 53 additions & 0 deletions guides/adobe-commerce/integration-test.pt.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,53 @@
# Testar pagamentos

Os testes de compras são essenciais para garantir que os pagamentos sejam processados corretamente antes de autorizar transações reais. Para verificar se a sua loja está configurada corretamente, recomendamos que você teste os pagamentos antes de iniciá-la em produção.

> WARNING
>
> Importante
>
> O teste só poderá ser realizado após a etapa de [configuração da integração.](/developers/pt/docs/adobe-commerce/integration-configuration)

Veja abaixo como testar a integração:
1. Acesse **[Suas integrações](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/panel/app)** no admin do Mercado Pago e selecione a aplicação que deseja testar.
2. Clique em **Contas de teste** no menu à esquerda.
3. Dentro da seção **Contas de teste**, clique em **Criar conta de teste** e crie duas contas diferentes: uma para vendedor e outra para comprador. Não é possível utilizar a mesma conta de teste para vendedor e comprador. Consulte a [documentação de Contas de teste](/developers/pt/docs/adobe-commerce/additional-content/your-integrations/test/accounts) para acessar o passo a passo de criação de contas teste.

![Criar conta](/images/adobe-commerce/test-create-account.gif)

4. Abra uma nova janela anônima e faça login no Mercado Pago usando a conta de teste do vendedor criada no passo anterior.
5. Na mesma janela anônima logada como vendedor, acesse o [Painel do desenvolvedor](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/panel/app) e crie uma nova aplicação, seguindo as instruções detalhadas na [documentação do Painel do desenvolvedor.](/developers/pt/docs/adobe-commerce/additional-content/your-integrations/dashboard)

![Login](/images/adobe-commerce/test-login.gif)

6. Acesse a aplicação criada no passo anterior e clique em **Credenciais de produção** no menu à esquerda. Copie o `access_token` e a `public_key`.

![Credenciais de produção](/images/adobe-commerce/test-prod-credentials.png)

7. Vá até as configurações do painel de Adobe Commerce (**Stores > Configuration > Sales > Payment Methods > Other payments methods > Configure > Basic Settings > Mercado Pago Integration**).
8. Selecione a opção **Production** no campo "Checkout operation mode".
9. Insira as credenciais produtivas `access_token` e `public_key` da conta de teste do vendedor.

![Painel](/images/adobe-commerce/test-adobe-commerce.png)

11. Clique em **Save Config**.
12. Abra uma nova janela anônima e faça login no Mercado Pago usando a conta de teste do comprador criada no passo 3.
----[mlb]----
13. Na mesma janela logada como comprador, acesse sua loja e efetue uma compra fornecendo informações de teste, como CPF, RG, telefone e e-mail da conta de teste do comprador. Utilize também os cartões de teste disponíveis na [documentação](/developers/pt/docs/adobe-commerce/additional-content/your-integrations/test/cards) correspondente.

------------
----[mla, mpe, mco, mlm, mco, mlu, mlc]----
13. Na mesma janela logada como comprador, acesse sua loja e efetue uma compra fornecendo informações de teste, como telefone e e-mail da conta de teste do comprador. Em "Documento", selecione a opção **OTRO** e insira 9 dígitos. Utilize também os cartões de teste disponíveis na [documentação](/developers/pt/docs/adobe-commerce/additional-content/your-integrations/test/cards) correspondente.

------------

> WARNING
>
> Importante
>
> Durante os testes, você estará operando no ambiente de produção, no entanto, trata-se de um teste no qual você estará utilizando credenciais fictícias para simular cenários reais. Ao concluir os testes, lembre-se de substituir as credenciais do vendedor (tanto de produção quanto de teste), inseridas no painel do plugin no passo 9, pelas credenciais reais da sua conta no Mercado Pago. Essa ação permitirá que você continue vendendo em sua loja e evitará confusões.
Após concluir uma compra de teste utilizando o Checkout Pro ou o Checkout----[mlb]---- Transparente------------ ----[mla, mpe, mco, mlm, mco, mlu, mlc]----API------------, a aprovação da compra será visível no Painel Administrativo de Adobe, com exceção das compras feitas por meios offline----[mlb]---- e Pix------------, que permanecerão com status pendente.

Além disso, os pedidos serão registrados no histórico da conta de teste de vendedor do Mercado Pago.
2 changes: 1 addition & 1 deletion guides/adobe-commerce/payment-configuration.en.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# Payment Configuration
# Payment configuration

The integration of the Mercado Pago module with the Adobe Commerce (Magento) store allows the use of two types of checkouts.

Expand Down
Loading

0 comments on commit 68d5533

Please sign in to comment.