Skip to content

Commit

Permalink
Merge pull request #619 from mercadopago/fix/iteracionv1
Browse files Browse the repository at this point in the history
Fix/iteracionv1
  • Loading branch information
Juan Ignacio Veltri authored Feb 4, 2020
2 parents 88aae07 + d858dd4 commit 7dc72ad
Show file tree
Hide file tree
Showing 17 changed files with 71 additions and 71 deletions.
2 changes: 1 addition & 1 deletion guides/manage-account/cancellations-and-refunds.es.md
Original file line number Diff line number Diff line change
Expand Up @@ -199,7 +199,7 @@ payment = MercadoPago::Payment.find_by_id(payment_id)
refunds = payment.refund()
```
```curl
curl -X POST \
curl -X GET \
-H "Content-Type: application/json" \
'https://api.mercadopago.com/v1/payments/:ID?access_token=ACCESS_TOKEN'
```
Expand Down
14 changes: 7 additions & 7 deletions guides/notifications/ipn.es.md
Original file line number Diff line number Diff line change
Expand Up @@ -47,20 +47,20 @@ payment | /v1/payments/[ID]?access\_token=[ACCESS\_TOKEN] | [ver docu
chargebacks | /v1/chargebacks/[ID]?access\_token=[ACCESS\_TOKEN]| -
merchant_orders | /merchant\_orders/[ID]?access\_token=[ACCESS\_TOKEN] | [ver documentación](https://www.mercadopago.com.ar/developers/es/reference/merchant_orders/_merchant_orders_id/get/)

### Tipo: merchant_orders
### Notificaciones de merchant_orders

**Si estas integrando pagos presenciales**, te recomendamos utilizar notificaciones IPN de topic `merchant_order`. Para ello, ten en cuenta las siguientes reglas:

1. El campo `status` de la merchant_order permanecerá en **opened** cuando aún no tenga pagos asociados, o los tenga y estén rechazados o aprobados por un monto menor al total de la orden.
2. El campo `status` de la merchant_order será **closed** cuando la suma de los pagos aprobados sea igual o mayor al total de la orden.
1. El campo `status` de la `merchant_order` permanecerá en **opened** cuando aún no tenga pagos asociados, o los tenga y estén rechazados o aprobados por un monto menor al total de la orden.
2. El campo `status` de la `merchant_order` será **closed** cuando la suma de los pagos aprobados sea igual o mayor al total de la orden.

Dentro de la orden, en el objeto payments, encontrarás todos los pagos de la misma. Es importante obtener el id de los pagos con `status` = **approved** para [poder realizar devoluciones](https://www.mercadopago.com.ar/developers/es/guides/manage-account/cancellations-and-refunds/).

> WARNING
>
> ADVERTENCIA
>
> * Cuando la merchant_order esté en estado **closed**, revisa que la sumatoria de los pagos en estado **approved** sea igual o mayor al total de la orden.
> Cuando la `merchant_order` esté en estado **closed**, revisa que la sumatoria de los pagos en estado **approved** sea igual o mayor al total de la orden.
### Implementa el receptor de notificaciones tomando como ejemplo el siguiente código:

Expand Down Expand Up @@ -108,15 +108,15 @@ Dentro de la orden, en el objeto payments, encontrarás todos los pagos de la mi
## Búsqueda de la orden

**Si estas integrando pagos presenciales**, se debe implementar como método de contingencia, la **búsqueda de la orden** utilizando el external_reference de la misma como criterio de búsqueda.
**Si estas integrando pagos presenciales**, se debe implementar como método de contingencia, la **búsqueda de la orden** utilizando el `external_reference` de la misma como criterio de búsqueda.

```curl
curl -X GET https://api.mercadopago.com/merchant_orders?external_reference=$EXTERNAL_REFERENCE&access_token=$ACCESS_TOKEN -d
```

Más información en la [Referencia de API](https://www.mercadopago.com.ar/developers/es/reference/merchant_orders/_merchant_orders_search/get/).

Se puede implementar la **búsqueda** por external_reference de dos formas:
Se puede implementar la **búsqueda** por `external_reference` de dos formas:

| Formas | Descripción |
| ----------- | ----------------- |
Expand Down Expand Up @@ -159,5 +159,5 @@ En caso contrario, la respuesta que se recibe si todavía **no se escaneó el QR
>
> ATENCIÓN
>
> * Desde Mercado Pago requerimos para homologar la integración de pagos presenciales que tengan implementada la notificación (IPN) como método principal. La búsqueda de orden por external_reference deberá usarse sólo como contingencia ante el eventual caso que no se reciban notificaciones.
> Desde Mercado Pago requerimos para homologar la integración de pagos presenciales que tengan implementada la notificación (IPN) como método principal. La búsqueda de orden por `external_reference` deberá usarse sólo como contingencia ante el eventual caso que no se reciban notificaciones.

2 changes: 1 addition & 1 deletion guides/qr-code/final-steps/advanced-integration.es.md
Original file line number Diff line number Diff line change
Expand Up @@ -35,7 +35,7 @@ Integra los [reportes de conciliación de Mercado Pago](https://www.mercadopago.
## 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.
Puedes encontrar todos los casos en la [sección de Pruebas](https://www.mercadopago.com.ar/developers/es/guides/qr-code/final-steps/integration-test/).

### Próximos pasos

Expand Down
2 changes: 1 addition & 1 deletion guides/qr-code/final-steps/advanced-integration.pt.md
Original file line number Diff line number Diff line change
Expand Up @@ -35,7 +35,7 @@ Integre os [relatórios de conciliação de Mercado Pago](https://www.mercadopag
## Teste e valide sua integração

Detalhamos todos os casos necessários que deve comprovar para validar que seu sistema esteja integrado corretamente com Mercado Pago.
Você pode achar todos os casos na seção de Testes.
Você pode achar todos os casos na [seção de Testes](https://www.mercadopago.com.ar/developers/pt/guides/qr-code/final-steps/integration-test/).

### Próximos passos

Expand Down
2 changes: 1 addition & 1 deletion guides/qr-code/final-steps/integration-test.es.md
Original file line number Diff line number Diff line change
Expand Up @@ -124,7 +124,7 @@ Cuando tengas la aplicación **lista y funcionando** en modalidad de prueba y qu
>
> IMPORTANTE
>
> * Si no completas el formulario de [Quiero ir a producción]([FAKER][CREDENTIALS][URL]), no podrás hacer ningun tipo de devoluciones.
> Si no completas el formulario de [Quiero ir a producción]([FAKER][CREDENTIALS][URL]), no podrás hacer ningun tipo de devoluciones.
## ¿Por qué es necesario este proceso?

Expand Down
4 changes: 2 additions & 2 deletions guides/qr-code/final-steps/integration-test.pt.md
Original file line number Diff line number Diff line change
Expand Up @@ -125,8 +125,8 @@ Quando tiver o aplicativo **pronto e funcionando** na modalidade de teste e quis
>
> IMPORTANTE
>
> * Se não preencher o formulário de [Quero ir para produção](FAKER][CREDENTIALS][URL]), não poderá fazer qualquer tipo de restituição.
> * Se não preencher o formulário de [Quero ir para produção](FAKER][CREDENTIALS][URL]), não poderá fazer qualquer tipo de restituição.
## Por que este processo é necessário?

Porque assim podemos garantir a segurança dos dados de seus clientes e conseguir a melhor experiência de compra, que contribua para maximizar a conversão dos pagamentos que receba. O inadimplemento destas normas pode acarretar desde o não processamento de pagamentos até ações legais conforme o estabelecido nos [termos e condições](https://www.mercadopago.com.br/ajuda/termos-e-condicoes_300).
Porque assim podemos garantir a segurança dos dados de seus clientes e conseguir a melhor experiência de compra, que contribua para maximizar a conversão dos pagamentos que receba. O inadimplemento destas normas pode acarretar desde o não processamento de pagamentos até ações legais conforme o estabelecido nos [termos e condições](https://www.mercadopago.com.br/ajuda/termos-e-condicoes_300).
Original file line number Diff line number Diff line change
Expand Up @@ -47,7 +47,7 @@ Puedes consultar tus ventas en el listado de actividades de [tu cuenta de Mercad
>
> ¿Qué es el código QR?
>
> Configura las notificaciones de tus pagos.
> Conoce cómo funciona cobrar con un código QR y cuáles son sus beneficios.
>
> [¿Qué es el código QR?](https://www.mercadopago.com.ar/developers/es/guides/qr-code/general-considerations/introduction/)
Expand Down
6 changes: 3 additions & 3 deletions guides/qr-code/general-considerations/pre-requisites.es.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,8 +19,8 @@ Sabemos que algunos términos son nuevos. Antes de empezar, te los dejamos a man
| -----------------------------------| ------------------------------------------------------------ |
| 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** en la opción _Checkout personalizado._ |
| `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. |
| `COLLECTOR_ID` | Es el ID del usuario vendedor en Mercado Pago, son los últimos 9 dígitos del `access_token`, posterior al guión medio. También se lo conoce como `USER_ID` |
| `SPONSOR_ID` | Es el ID del usuario proveedor del sistema integrado con Mercado Pago, son los últimos 9 dígitos del `access_token`, posterior al guión medio. El `sponsor_ID` no puede ser igual al `COLLECTOR_ID`. |
| `COLLECTOR_ID` | ID de la cuenta de Mercado Pago. Se compone por los dígitos posteriores al guión medio del `access_token`. También lo puedes encontrar como _`USER_ID`_. |
| `SPONSOR_ID` | Es el `collector_ID` del usuario proveedor del sistema integrado con Mercado Pago. El `sponsor_ID` no puede ser igual al `collector_id`. |
| Sucursal | 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 | Es un **punto de venta** 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.
Expand Down Expand Up @@ -50,4 +50,4 @@ Si aún no tienes una, puedes [crear una cuenta de Mercado Pago](https://www.mer
>
> Para realizar la integración, primero debes configurar tus sucursales y cajas.
>
> [Sucursales y Cajas](https://www.mercadopago.com.ar/developers/es/guides/qr-code/general-considerations/integrations/)
> [Sucursales y Cajas](https://www.mercadopago.com.ar/developers/es/guides/qr-code/general-considerations/stores-pos/)
2 changes: 1 addition & 1 deletion guides/qr-code/general-considerations/pre-requisites.pt.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@ Sabemos que alguns termos são novos. Antes de começar, os deixamos perto de su
| `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**. |
| `COLLECTOR_ID` | É o ID do usuário vendedor em Mercado Pago, são os últimos 9 dígitos do access_token, posterior hífen. Também conhecido como `USER_ID` |
| `SPONSOR_ID` | É o ID do usuário fornecedor do sistema integrado com Mercado Pago, são os últimos 9 dígitos do `access_token`, posterior ao hífen. O `sponsor_ID` não pode ser igual que o `COLLECTOR_ID`. |
| Loja | É uma **loja física** onde seus clientes podem adquirir seus produtos ou serviços. Você pode ter várias sucursais numa mesma conta. |
| Loja | É uma **loja física** onde seus clientes podem adquirir seus produtos ou serviços. Você pode ter várias lojas numa mesma conta. |
| Caixa | É um **ponto de venda** que existe numa sucursal 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.

Expand Down
6 changes: 3 additions & 3 deletions guides/qr-code/general-considerations/stores-pos.es.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@ Las **sucursales** y **cajas** son importantes para recibir pagos presenciales c

### ¿Cuáles son los beneficios de crear sucursales?

Los beneficios de crear Sucursales son:
Los beneficios de crear sucursales son:

- **Lograr trazabilidad**. Cada pago quedará asociado a una sucursal y al momento de obtener tus reportes de conciliación será valioso para identificar transacciones por sucursal.
- **Visibilidad en mapas de sucursales**. Las sucursales creadas aparecen en el mapa de las app de Mercado Pago o Mercado Libre a medida que vayan teniendo pagos. De esta manera, dan visibilidad a todos los clientes sobre la existencia de la tienda.
Expand Down Expand Up @@ -86,7 +86,7 @@ Al tener creadas tus sucursales, puedes crear tus cajas. Ten en cuenta lo siguie

| Término | Descripción |
| ------------- | ------------------------------------------------------------ |
| `EXTERNAL_STORE_ID` | Vincula la Caja con la Sucursal. Es un campo requerido y es el mismo *external_id* de la Sucursal previamente creada. |
| `EXTERNAL_STORE_ID` | Vincula la caja con la sucursal. Es un campo requerido y es el mismo *external_id* de la Sucursal previamente creada. |
| `EXTERNAL_ID` | Identifica unívocamente cada caja. Es requerido y no se puede modificar, tampoco repetir en una misma cuenta de Mercado Pago. |
| `URL` | Sólamente es utilizado en el modelo desatendido. En este campo se declara la URL de un servicio de tu dominio al cual Mercado Pago consultará si hay una orden disponible. |

Expand All @@ -106,7 +106,7 @@ curl -X POST https://api.mercadopago.com/pos?access_token=PROD_ACCESS_TOKEN -d

Puedes obtener más información en la [Referencias de API](https://www.mercadopago.com.ar/developers/es/reference/pos/_pos/post/).

Una vez creada la caja, podremos ver en el “Response” los links a distintos entregables del QR, junto con otros datos relevantes de la caja.
Una vez creada la caja, podremos ver en el _Response_ los links a distintos entregables del QR, junto con otros datos relevantes de la caja.



Expand Down
16 changes: 8 additions & 8 deletions guides/qr-code/general-considerations/stores-pos.pt.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ sites_supported:
- mlb
---

# Sucursais e Caixas
# Lojas e Caixas

## Introdução

Expand All @@ -28,15 +28,15 @@ As **lojas** e **caixas** são os conceitos que você usará no Mercado Pago par

### Quais são os benefícios de criar sucursais?

Os benefícios de criar Sucursais são:
Os benefícios de criar lojas são:

- **Conseguir traçabilidade**. Cada pagamento ficará associado a uma sucursal e no momento de obter seus relatórios de conciliação será valioso para identificar transações por sucursal.
- **Visibilidade em mapas de sucursais**. As sucursais criadas aparecem no mapa dos app de Mercado Pago ou Mercado Livre à medida que forem tendo pagamentos. Assim, conferem visibilidade a todos os clientes sobre a existência da loja.
- **Aportar uma melhor organização dos caixas**.

### Como criar uma sucursal?
### Como criar uma loja?

Para criar uma sucursal, você tem que declarar seu nome, horários de trabalho, localização e alguma referência que o identifique.
Para criar uma loja, você tem que declarar seu nome, horários de trabalho, localização e alguma referência que o identifique.

Para gerá-la, execute o código a seguir:

Expand Down Expand Up @@ -82,11 +82,11 @@ Você pode obter mais informações nas [Referências de API](https://www.mercad

## Caixas

Tendo sucursais criadas, você pode criar seus caixas. Considere o seguinte:
Tendo lojas criadas, você pode criar seus caixas. Considere o seguinte:

| Termo | Descrição |
| ------------- | ------------------------------------------------------------ |
| `EXTERNAL_STORE_ID` | Vincula o Caixa com a Sucursal. É um campo requerido e é o mesmo *external_id* da Sucursal previamente criada. |
| `EXTERNAL_STORE_ID` | Vincula o caixa com a loja. É um campo requerido e é o mesmo *external_id* da Sucursal previamente criada. |
| `EXTERNAL_ID` | Identifica univocamente cada caixa. É requerido e não se pode alterar nem repetir numa mesma conta de Mercado Pago. |
| `URL` | Somente é utilizado no modelo desatendido. Neste campo se declara o URL de um serviço de seu domínio ao qual Mercado Pago consultará se houver um pedido disponível. |

Expand All @@ -106,7 +106,7 @@ curl -X POST https://api.mercadopago.com/pos?access_token=PROD_ACCESS_TOKEN -d

Você pode obter mais informações em [Referências de API](https://www.mercadopago.com.br/developers/pt/reference/pos/_pos/post/).

Uma vez criado o caixa, poderemos ver no “Response” os links para diferentes entregáveis do QR, junto com outros dados relevantes do caixa.
Uma vez criado o caixa, poderemos ver no _Response_ os links para diferentes entregáveis do QR, junto com outros dados relevantes do caixa.



Expand All @@ -128,4 +128,4 @@ Uma vez criado o caixa, poderemos ver no “Response” os links para diferentes
>
> Se a venda só pode ser concretizada com a ação do cliente, esse é o seu modelo!
>
> [Integrar o modelo autônomo do QR](https://www.mercadopago.com.br/developers/pt/guides/qr-code/qr-unattended/qr-unattended-part-a/)
> [Integrar o modelo autônomo do QR](https://www.mercadopago.com.br/developers/pt/guides/qr-code/qr-unattended/qr-unattended-part-a/)
2 changes: 1 addition & 1 deletion guides/qr-code/qr-attended/qr-attended-part-a.es.md
Original file line number Diff line number Diff line change
Expand Up @@ -51,7 +51,7 @@ Te explicamos cómo funciona el modelo atendido:
(C) Y confirma su recepción.
7. (A) El servidor del vendedor consulta el estado de la orden con el ID recibido en la última notificación para saber si está cerrada o si sigue abierta, pendiente de pago.<br/>
(B) Mercado Pago devuelve los datos correspondientes como su estado, información de pagos, entre otros.
8. Si la orden se encuentra cerrada (**closed**), se puede imprimir el comprobante para finalizar la transacción.
8. Si la orden se encuentra cerrada (_closed_), se puede imprimir el comprobante para finalizar la transacción.

> NOTE
>
Expand Down
2 changes: 1 addition & 1 deletion guides/qr-code/qr-attended/qr-attended-part-a.pt.md
Original file line number Diff line number Diff line change
Expand Up @@ -51,7 +51,7 @@ Explicamos a você o funcionamento do modelo atendido:
(C) E confirma seu recebimento.
7. (A) O server do vendedor consulta o estado do pedido com o ID recebido na última notificação para saber se está fechado ou se continua aberto, pendente de pagamento.
(B) Mercado Pago restitui os dados correspondentes, como seu estado, informação de pagamentos, entre outros.
8. Se o pedido estiver encerrado (**closed**), o comprovante pode ser impresso para finalizar a operação.
8. Se o pedido estiver encerrado (_closed_), o comprovante pode ser impresso para finalizar a operação.

> NOTE
>
Expand Down
10 changes: 5 additions & 5 deletions guides/qr-code/qr-attended/qr-attended-part-b.es.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,15 +22,15 @@ https://api.mercadopago.com/mpmobile/instore/qr/$USER_ID/$EXTERNAL_ID?access_tok
"external_reference": "Factura-0001",
"notification_url": "www.yourserver.com",
"items" :[{
"title" : [FAKER][COMMERCE][PRODUCT_NAME],
"title" : "Producto 1",
"currency_id" : [FAKER][CURRENCY][ACRONYM],
"unit_price" : 120.00,
"quantity" : 1,
"description": "Producto de Mercado Pago",
"picture_url": "https://bit.ly/2lCRcEN"
},
{
"title" : [FAKER][COMMERCE][PRODUCT_NAME],
"title" : "Producto 2",
"currency_id" : [FAKER][CURRENCY][ACRONYM],
"unit_price" : 100.00,
"quantity" : 2
Expand All @@ -50,8 +50,8 @@ Puedes obtener más información en la [Referencias de API](https://www.mercadop

Por defecto, la orden del QR expira a los 10 minutos de ser creada o automáticamente al ser cerrada.

Si se requiere un tiempo de expiración diferente, se puede enviar el header `X-Ttl-Store-Preference` con el tiempo deseado en segundos.
Por ejemplo, para que esté disponible durante 5 minutos se debe enviar el header `X-Ttl-Store-Preference`: 300.
Si se requiere un tiempo de expiración diferente, se puede enviar el _header_ `X-Ttl-Store-Preference` con el tiempo deseado en segundos.
Por ejemplo, para que esté disponible durante 5 minutos se debe enviar el _header_ `X-Ttl-Store-Preference`: 300.

## Eliminar una orden

Expand All @@ -69,7 +69,7 @@ La respuesta será un `HTTP 204 No Content`.
>
> Integración avanzada
>
> Conoce las opciones que dispones para llegar la integración al siguiente nivel.
> Conoce las opciones que dispones para llevar tu integración al siguiente nivel.
>
> [Integrar o modelo QR atendido](https://www.mercadopago.com.ar/developers/es/guides/qr-code/final-steps/advanced-integration/)
Expand Down
6 changes: 3 additions & 3 deletions guides/qr-code/qr-attended/qr-attended-part-b.pt.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,15 +22,15 @@ https://api.mercadopago.com/mpmobile/instore/qr/$USER_ID/$EXTERNAL_ID?access_tok
"external_reference": "Ticket-0001",
"notification_url": "www.yourserver.com",
"items" :[{
"title" : [FAKER][COMMERCE][PRODUCT_NAME],
"title" : "Produto 1",
"currency_id" : [FAKER][CURRENCY][ACRONYM],
"unit_price" : 120.00,
"quantity" : 1,
"description": "Producto de Mercado Pago",
"description": "Produto de Mercado Pago",
"picture_url": "https://bit.ly/2lCRcEN"
},
{
"title" : [FAKER][COMMERCE][PRODUCT_NAME],
"title" : "Produto 1",
"currency_id" : [FAKER][CURRENCY][ACRONYM],
"unit_price" : 100.00,
"quantity" : 2
Expand Down
Loading

0 comments on commit 7dc72ad

Please sign in to comment.