Skip to content

Commit

Permalink
post method
Browse files Browse the repository at this point in the history
  • Loading branch information
rwaetemann committed Jul 31, 2023
2 parents ade2a0e + d3b7c54 commit c8cfa92
Show file tree
Hide file tree
Showing 9 changed files with 400 additions and 0 deletions.
Original file line number Diff line number Diff line change
@@ -0,0 +1,54 @@
# Advanced Integration

## Refunds

----[mla, mlm, mco, mlu, mlb, mlc]----

Refunds happen when a payment was completed but the seller decides to cancel it partially or totally. You can find information in the [Refunds and cancellations](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/en/guides/manage-account/account/cancellations-and-refunds) section.

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

----[mpe]----

Refunds happen when a payment was completed but the seller decides to cancel it totally. You can find more information in the [Refunds and cancellations](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/en/guides/manage-account/account/cancellations-and-refunds) section.

------------
> WARNING
>
> Note
>
> Remember that in the case QR payments, refunds are available but cancellations are not.


## Get order data

If you want to assign an order to a POS, you can do it using the following:

```curl
curl -X GET \
-H 'Authorization: Bearer ACCESS_TOKEN' \
https://api.mercadopago.com/instore/qr/seller/collectors/USER_ID/pos/EXTERNAL_POS_ID/orders
```
Obtain more information in our [API Reference](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/en/reference/instore_orders_v2/_instore_qr_seller_collectors_user_id_pos_external_pos_id_orders/get).

## Generate reports of your sales

Integrate [Mercado Pago reports](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/en/guides/manage-account/reports/general-considerations/reconciliation-reports) with your system to make sales reconcilitation and know about your account movements.

## Test and validate your integration

We detailed all necessary scenarios you should test to ensure your system is successfully integrated with Mercado Pago.
Find all this information in the [Tests section](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/en/guides/in-person-payments/qr-code/integration-test).

---
### Next steps


> LEFT_BUTTON_RECOMMENDED_EN
>
> Test your integration
>
> Perform the most frequent use cases to validate your integration.
>
> [Test your integration](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/en/guides/in-person-payments/qr-code/integration-test)
Original file line number Diff line number Diff line change
@@ -0,0 +1,61 @@
# Integración avanzada

## Devoluciones de tus pagos

----[mla, mlm, mco, mlu, mlb, mlc]----

Las devoluciones suceden cuando el pago se realizó pero el vendedor decide anularlo total o parcialmente.
Puedes encontrar toda la información en la [sección Devoluciones y cancelaciones](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/es/guides/manage-account/account/cancellations-and-refunds).

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

----[mpe]----

Las devoluciones suceden cuando el pago se realizó pero el vendedor decide anularlo totalmente.
Puedes encontrar toda la información en la [sección Devoluciones y cancelaciones](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/es/guides/manage-account/account/cancellations-and-refunds).

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

> WARNING
>
> Nota
>
> Ten en cuenta que para pagos presenciales, solo puedes efectuar devoluciones pero no cancelaciones.
Vea el proceso de reversión de pagos a través de QR CODE, [en este video tutorial](https://youtu.be/JXzDIos_fRA?list=PLCazXKuqZp3hGVY3bBhEO0ItFhIic5UpK).


## Obtener datos de la orden

Si deseas obtener la orden vigente de una caja, también puedes hacerlo.

```curl
curl -X GET \
-H 'Authorization: Bearer ACCESS_TOKEN' \
https://api.mercadopago.com/instore/qr/seller/collectors/USER_ID/pos/EXTERNAL_POS_ID/orders
```
Puedes obtener más información en la [Referencias de API](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/es/reference/instore_orders_v2/_instore_qr_seller_collectors_user_id_pos_external_pos_id_orders/get).


## Genera reportes de tus ventas

Integra los [reportes de conciliación de Mercado Pago](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/es/guides/manage-account/reports/general-considerations/reconciliation-reports) con tu sistema para conciliar tus ventas y conocer los movimientos de tu cuenta.

## Prueba y valida tu integración

Detallamos todos los casos necesarios que debes probar para validar que tu sistema esté integrado correctamente con Mercado Pago.
Puedes encontrar todos los casos en la [sección de Pruebas](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/es/guides/in-person-payments/qr-code/integration-test).

Vea más detalles en este [video tutorial](https://youtu.be/oQqJkqyjegk?list=PLCazXKuqZp3hGVY3bBhEO0ItFhIic5UpK).

---
### Próximos pasos


> LEFT_BUTTON_RECOMMENDED_ES
>
> Prueba tu integración
>
> Realiza los casos de uso más frecuentes para validar tu integración.
>
> [Prueba tu integración](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/es/guides/in-person-payments/qr-code/integration-test)
39 changes: 39 additions & 0 deletions guides/shopify/how-tos-migrate-cho-api.en 2.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,39 @@
# How to migrate to the new version of the Mercado Pago app

Learn how to install the new app and uninstall the old one to avoid service interruption in Shopify.

## Install the new app

1. Go to your [Shopify](https://accounts.shopify.com/store-login) store.
2. In the store's administrative panel, click on **Settings**.
3. Once there, select the **Payments** option.
4. In "Additional payment methods", click on the **Add payment methods** option.
5. Go to the **Search by provider** tab and look for the new app with the name "Checkout Mercado Pago".
6. Once you have found it, select it and click **Activate** and then **Connect**.
7. Select **Install App** and then **Manage**.
8. Put your **production credentials** (`public key` and `access token`) in the fields that request it and click **Save**. Remember to keep your [credentials](/developers/en/docs/shopify/additional-content/credentials) handy.
9. To finish the installation, select **Activate Checkout Mercado Pago**.

> In this step, you can select the images of the means of payment that you want to show in your store for illustrative purposes. Also, if you wish, you can enable [test mode.](/developers/en/docs/shopify/sales-processing/integration-test)
> NOTE
>
> Important
>
> At this exact moment, you are going to have both versions installed on your site. This will ensure that your store does not run out of payment methods while the migration steps are taking place.
## Deactivate the old app

After installing the new version, it is necessary to uninstall the old version following the step by step below.

1. Go to your [Shopify](https://accounts.shopify.com/store-login) store.
2. In the store's administrative panel, click on **Settings**.
3. Once there, select the **Payments** option.
4. Find the old app with the name "Mercado Pago" and select **Manage**.
5. To finish, click on **Deactivate Mercado Pago**.

> WARNING
>
> Attention
>
> Be careful to not uninstall the new version.
58 changes: 58 additions & 0 deletions guides/shopify/how-tos-migrate-cho-api.es 2.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,58 @@
# Cómo migrar a la nueva versión de la app de Mercado Pago

Aprende a instalar la nueva app y desinstalar la antigua para evitar la interrupción del servicio en Shopify.

## Instala la nueva app

1. Ve a tu tienda [Shopify](https://accounts.shopify.com/store-login).
2. Dentro del panel administrativo de la tienda, haz clic en **Configuración**.
3. Una vez allí, selecciona la opción **Pagos**.
4. En "Formas de pago adicionales", haz clic en **Agregar formas de pago**.
5. Dirígete a la pestaña **Buscar por proveedor** y busca la nueva app con el nombre "Checkout Mercado Pago".
6. Una vez que la hayas encontrado, selecciónala y haz clic en **Activar”** y luego **Conectar**.

<center>

![migracion a](/images/shopify/migration-a-es.gif)

</center>

7. Selecciona **Instalar aplicación** y luego **Gestionar**.
8. Coloca tus **credenciales de producción** (`public key` y `access token`) en los campos que lo solicitan y haz clic en **Guardar**. Recuerda tener a mano tus [credenciales](/developers/es/docs/shopify/additional-content/credentials).
9. Para terminar la instalación, selecciona **Activar Checkout Mercado Pago**.

> En este paso, podrás seleccionar las imágenes de los medios de pago que quieras mostrar en tu tienda a modo ilustrativo. También, en caso que lo desees, podrás habilitar el [modo de prueba.](/developers/pt/docs/shopify/sales-processing/integration-test)
<center>

![migracion b](/images/shopify/migration-b-es.gif)

</center>

> NOTE
>
> Importante
>
> En este exacto momento, vas a tener las dos versiones instaladas en tu sitio. Esto asegurará que tu tienda no se quede sin métodos de pago mientras se realizan los pasos de migración.
## Desactiva la app antigua

Después de instalar la nueva versión, es necesario desinstalar la versión anterior siguiendo el paso a paso a continuación.

1. Ve a tu tienda [Shopify](https://accounts.shopify.com/store-login).
2. Dentro del panel administrativo de la tienda, haz clic en **Configuración**.
3. Una vez allí, selecciona la opción **Pagos**.
4. Localiza la antigua app con el nombre "Mercado Pago" y selecciona **Gestionar**.
5. Para finalizar, haz clic en **Desactiva Mercado Pago**.

> WARNING
>
> Atención
>
> Ten cuidado de no desinstalar la nueva versión.
<center>

![migracion c](/images/shopify/migration-c-es.gif)

</center>
39 changes: 39 additions & 0 deletions guides/shopify/how-tos-migrate-cho-api.pt 2.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,39 @@
# Como migrar para a nova versão do app Mercado Pago

Saiba como instalar o novo app e desinstalar o antigo para evitar a interrupção do serviço na Shopify.

## Instale o novo app

1. Vá para a sua loja [Shopify](https://accounts.shopify.com/store-login).
2. No painel administrativo da loja, clique em **Configurações**.
3. Uma vez lá, selecione a opção **Pagamentos**.
4. Em "Formas de pagamento adicionais", clique em **Adicionar formas de pagamento**.
5. Acesse a aba **Pesquisar por fornecedor** e procure o novo app com o nome "Checkout Mercado Pago".
6. Após localizá-lo, selecione-o, clique em **Ativar** e, por fim, em **Conectar**.
7. Selecione **Instalar app** e, depois, clique em **Gerenciar**.
8. Insira as suas **credenciais de produção** (`public key` e `access token`) nos campos solicitados e clique em **Salvar**. Lembre-se de ter suas [credenciais](/developers/pt/docs/shopify/additional-content/credentials) à mão.
9. Para finalizar a instalação, clique em **Ativar Checkout Mercado Pago**.

> Nesta etapa, você pode selecionar as imagens dos meios de pagamento que deseja exibir em sua loja para fins ilustrativos. Além disso, se desejar, você pode ativar o [modo de teste.](/developers/pt/docs/shopify/sales-processing/integration-test)
> NOTE
>
> Importante
>
> Neste exato momento você terá ambas as versões instaladas em seu site. Isso servirá para garantir que a sua loja não fique sem nenhum meio de pagamento enquanto estiverem sendo realizadas as etapas de migração.
## Desative o antigo app

Feita a instalação da nova versão, é necessário desinstalar a antiga versão seguindo o passo a passo abaixo.

1. Vá para sua loja [Shopify](https://accounts.shopify.com/store-login).
2. No painel administrativo da loja, clique em **Configurações**.
3. Uma vez lá, selecione a opção **Pagamentos**.
4. Localize o antigo app com o nome "Mercado Pago" e selecione **Gerenciar**.
5. Por fim, clique em **Desativar Mercado Pago**.

> WARNING
>
> Atenção
>
> Tenha cuidado para não desinstalar a nova versão.
39 changes: 39 additions & 0 deletions guides/shopify/how-tos-migrate-cho-pro.en 2.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,39 @@
# How to migrate to the new version of the Mercado Pago app

Learn how to install the new app and uninstall the old one to avoid service interruption in Shopify.

## Install the new app

1. Go to your [Shopify](https://accounts.shopify.com/store-login) store.
2. In the store's administrative panel, click on **Settings**.
3. Once there, select the **Payments** option.
4. In "Additional payment methods", click on the **Add payment methods** option.
5. Go to the **Search by provider** tab and look for the new app with the name "Checkout Mercado Pago".
6. Once you have found it, select it and click **Activate** and then **Connect**.
7. Select **Install App** and then **Manage**.
8. Put your **production credentials** (`public key` and `access token`) in the fields that request it and click **Save**. Remember to keep your [credentials](/developers/en/docs/shopify/additional-content/credentials) handy.
9. To finish the installation, select **Activate Checkout Mercado Pago**.

> In this step, you can select the images of the means of payment that you want to show in your store for illustrative purposes. Also, if you wish, you can enable [test mode.](/developers/en/docs/shopify/sales-processing/integration-test)
> NOTE
>
> Important
>
> At this exact moment, you are going to have both versions installed on your site. This will ensure that your store does not run out of payment methods while the migration steps are taking place.
## Deactivate the old app

After installing the new version, it is necessary to uninstall the old version following the step by step below.

1. Go to your [Shopify](https://accounts.shopify.com/store-login) store.
2. In the store's administrative panel, click on **Settings**.
3. Once there, select the **Payments** option.
4. Find the old app with the name "Mercado Pago" and select **Manage**.
5. To finish, click on **Deactivate Mercado Pago**.

> WARNING
>
> Attention
>
> Be careful to not uninstall the new version.
58 changes: 58 additions & 0 deletions guides/shopify/how-tos-migrate-cho-pro.es 2.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,58 @@
# Cómo migrar a la nueva versión de la app de Mercado Pago

Aprende a instalar la nueva app y desinstalar la antigua para evitar la interrupción del servicio en Shopify.

## Instala la nueva app

1. Ve a tu tienda [Shopify](https://accounts.shopify.com/store-login).
2. Dentro del panel administrativo de la tienda, haz clic en **Configuración**.
3. Una vez allí, selecciona la opción **Pagos**.
4. En "Formas de pago adicionales", haz clic en **Agregar formas de pago**.
5. Dirígete a la pestaña **Buscar por proveedor** y busca la nueva app con el nombre "Checkout Mercado Pago".
6. Una vez que la hayas encontrado, selecciónala y haz clic en **Activar”** y luego **Conectar**.

<center>

![migracion a](/images/shopify/migration-a-es.gif)

</center>

7. Selecciona **Instalar aplicación** y luego **Gestionar**.
8. Coloca tus **credenciales de producción** (`public key` y `access token`) en los campos que lo solicitan y haz clic en **Guardar**. Recuerda tener a mano tus [credenciales](/developers/es/docs/shopify/additional-content/credentials).
9. Para terminar la instalación, selecciona **Activar Checkout Mercado Pago**.

> En este paso, podrás seleccionar las imágenes de los medios de pago que quieras mostrar en tu tienda a modo ilustrativo. También, en caso que lo desees, podrás habilitar el [modo de prueba.](/developers/pt/docs/shopify/sales-processing/integration-test)
<center>

![migracion b](/images/shopify/migration-b-es.gif)

</center>

> NOTE
>
> Importante
>
> En este exacto momento, vas a tener las dos versiones instaladas en tu sitio. Esto asegurará que tu tienda no se quede sin métodos de pago mientras se realizan los pasos de migración.
## Desactiva la app antigua

Después de instalar la nueva versión, es necesario desinstalar la versión anterior siguiendo el paso a paso a continuación.

1. Ve a tu tienda [Shopify](https://accounts.shopify.com/store-login).
2. Dentro del panel administrativo de la tienda, haz clic en **Configuración**.
3. Una vez allí, selecciona la opción **Pagos**.
4. Localiza la antigua app con el nombre "Mercado Pago" y selecciona **Gestionar**.
5. Para finalizar, haz clic en **Desactiva Mercado Pago**.

> WARNING
>
> Atención
>
> Ten cuidado de no desinstalar la nueva versión.
<center>

![migracion c](/images/shopify/migration-c-es.gif)

</center>
Loading

0 comments on commit c8cfa92

Please sign in to comment.