Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Documentación de ecosistema presencial #2114

Open
wants to merge 45 commits into
base: development
Choose a base branch
from
Open
Changes from 1 commit
Commits
Show all changes
45 commits
Select commit Hold shift + click to select a range
eff1133
documentación de ecosistema presencial
pcanosa Jul 31, 2023
c6b7c4b
fixes de contenido y código
pcanosa Aug 1, 2023
44e9722
fixes en iniciar sesión, activar pdv e intents para QR
pcanosa Aug 2, 2023
f966e10
Fixes
pcanosa Aug 2, 2023
24b92cd
incorporación de archivos YAML provisorios para API Ref
pcanosa Aug 2, 2023
32eefa4
fixes traducciones en endpoints point
pcanosa Aug 3, 2023
54e9e48
se suma glosario en español
pcanosa Aug 3, 2023
d0d185a
traducciones a los endpoint de qr y dispositivos
pcanosa Aug 3, 2023
9855e49
landing en es
pcanosa Aug 4, 2023
5a4ff95
fixes landing es
pcanosa Aug 4, 2023
6fb2f92
fix landing
pcanosa Aug 4, 2023
855333a
fixes en varios archivos y agregado de flujo de prueba de integración
pcanosa Aug 4, 2023
cd947a4
fix landing
pcanosa Aug 4, 2023
62f680a
heits
hgaldino Aug 4, 2023
f92ac1d
heits2
hgaldino Aug 4, 2023
daca81d
heits3
hgaldino Aug 4, 2023
47fa3d2
heits4
hgaldino Aug 4, 2023
ecc4fe6
heits5
hgaldino Aug 4, 2023
9b42db9
fixes
pcanosa Aug 4, 2023
df143d0
fix links a api ref
pcanosa Aug 4, 2023
0832ab3
agregado de archivos en pt
pcanosa Aug 7, 2023
917c79c
incorporación de archivos en pt
pcanosa Aug 7, 2023
95d0a88
fixed identation issues
rwaetemann Aug 7, 2023
89f1c55
fixes
pcanosa Aug 7, 2023
1f05191
agregado de archivos en EN
pcanosa Aug 7, 2023
4c0569d
agregado de archivos en EN
pcanosa Aug 8, 2023
908695b
add landing EN
pcanosa Aug 8, 2023
a9c2302
fixes
pcanosa Aug 8, 2023
592cc2e
fixes nombre de la API en inglés
pcanosa Aug 9, 2023
c5f6415
fix error
bacarvalho Aug 14, 2023
5bd8eb5
Fixed all file
bacarvalho Aug 14, 2023
72357d6
fixes identation mla
pcanosa Aug 15, 2023
666f3b1
prueba de respuesta exitosa
pcanosa Aug 16, 2023
c330da7
fixes en la beta
pcanosa Aug 16, 2023
809cc17
fix endpoints docu
pcanosa Aug 16, 2023
4f36f6e
fixes
pcanosa Aug 16, 2023
0105233
fixes
pcanosa Aug 16, 2023
6febb63
fixes
pcanosa Aug 17, 2023
26b741a
fixes endpoints
pcanosa Aug 17, 2023
e0e328a
Fixes yaml mla
pcanosa Aug 18, 2023
bd3c432
Fixes mlb
pcanosa Aug 18, 2023
c316ef1
eliminación de error 409 y de extra cash y cash out para qr
pcanosa Aug 18, 2023
ea0338a
eliminación de cashout de los json
pcanosa Aug 18, 2023
1614148
renaming
pcanosa Sep 6, 2023
9decdf6
fixes
pcanosa Sep 7, 2023
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
fixes de contenido y código
pcanosa committed Aug 1, 2023
commit c6b7c4b1c40c15cc566e06f18d48ba2cca113404
93 changes: 52 additions & 41 deletions guides/ecosistema-presencial/create-and-manage-intent-point.es.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,10 @@
# Crear y administrar intents en dispositivos Point

A continuación, puedes ver cómo crear un intent en dispositivos Point, cómo consultar su estado, y cómo cancelarlo, así como la vía para configurar sus notificaciones.

## Crear intent en dispositivos Point

Para crear un intent en tu dispositivo Point, realiza una llamada POST a la API [https://api.mercadopago.com/instore-api/integrations/v1/intents/point/pos/{external.id}}]() reemplazando `external.id` por el valor obtenido al crear la caja.
Para crear un intent en tu dispositivo Point, realiza una llamada POST a la API [https://api.mercadopago.com/instore-api/integrations/v1/intents/point/pos/{external.id}}]() reemplazando `external.id` por el valor escogido al crear la caja.

----[mlb]----
> Ten en cuenta que para el campo `amount`, el monto mínimo permitido es 1.00, y el máximo 70000.00.
@@ -12,44 +14,6 @@ Para crear un intent en tu dispositivo Point, realiza una llamada POST a la API
> Ten en cuenta que para el campo `amount`, el monto mínimo permitido es 5.00, y el máximo 4000000.00.
------------

Adicionalmente, recomendamos **configurar tus notificaciones Webhook**. Estas facilitarán que recibas información en tiempo real cada vez que un intent llega a un estado final.

Para configurar tus notificaciones, sigue las instrucciones proporcionadas en la [documentación de notificaciones Webhooks](/developers/es/docs/ecosistema-presencial/additional-content/your-integrations/notifications/webhooks).

A continuación, te mostramos un ejemplo de notificación que puedes recibir para un dispositivo Point cuando un intent llega a un estado (`status`) final. Ten en cuenta que la información que se notifica dentro del nodo `data` va a depender de la información con la que se cree el intent.

``` json
{
"action": "topic_instore_integration_wh.application.authorized",
"api_version": "v1",
"data": {
"enabler_configuration": {
"ticket_number": "Ticket001",
"device_payment_mode": "CARD",
"print_on_terminal": [
"SELLER_TICKET"
]
},
"external_reference": "123132342341",
"id": "1234567-12345-12345678-1234567890",
"operations": [
{
"amount": "10.14",
"type": "PURCHASE"
}
],
"status": "CANCELED",
"url": "https://api.mercadopago.com/instore-api/integrations/v1/intents/1234567-12345-12345678-1234567890/point"
},
"date_created": "2023-07-27 20:24:21.776642198-0400",
"id": "1234567-12345-12345678-1234567890",
"live_mode": true,
"type": "topic_instore_integration_wh",
"user_id": 12345667
}

```

## Consultar el estado de un intent en dispositivos Point

Para conocer el estado actual de un intent, realiza una llamada GET a la API [https://api.mercadopago.com/instore-api/integrations/v1/intents/{{intent_id}}/point](), reemplazando `intent_id` por el valor obtenido en ese campo al momento de crearlo.
@@ -85,7 +49,7 @@ A continuación, te mostramos un ejemplo de respuesta a la consulta de un estado
```

Dentro del campo `status` podrás ver el estado del intent. Los únicos estados finales son `CANCELED`, `CLOSED`, `EXPIRED` , `ERROR` y `CONFIRMATION_REQUIRED`.
Para obtener más información sobre los estados posibles de un intent, dirígete al [Glosario](/developers/es/docs/ecosistema-presencial/additional-content/glossary).
Para obtener más información sobre los estados posibles de un intent, dirígete al [Glosario](/developers/es/docs/ecosistema-presencial/glossary).

Ten en cuenta que, para el estado final `Closed`, verás en la respuesta el nodo adicional `results`. Este nodo contiene la información del pago relacionada a los resultados de la operación; es decir, el listado de transacciones asociadas a la misma.

@@ -106,4 +70,51 @@ Realiza una llamada DELETE a la API [https://api.mercadopago.com/instore-api/int
>
> Importante
>
> Ten en cuenta que sólo se permite la cancelación de un intent por este método si su estado es `opened`. En caso de que este no sea el estado actual del intent que estás queriendo cancelar y, en cambio, sea `on_terminal`, deberás hacerlo desde el dispositivo Point. Para más información sobre los posibles estados de un intent, dirígete al [Glosario](/developers/es/docs/ecosistema-presencial/additional-content/glossary).
> Ten en cuenta que sólo se permite la cancelación de un intent por este método si su estado es `opened`. En caso de que este no sea el estado actual del intent que estás queriendo cancelar y, en cambio, sea `on_terminal`, deberás hacerlo desde el dispositivo Point. Para más información sobre los posibles estados de un intent, dirígete al [Glosario](/developers/es/docs/ecosistema-presencial/glossary).

## Configurar notificaciones

Adicionalmente, recomendamos **configurar tus notificaciones Webhook**. Estas facilitarán que recibas información en tiempo real cada vez que un intent llega a un estado final.

Para configurar tus notificaciones, sigue las instrucciones proporcionadas en la [documentación de notificaciones Webhooks](/developers/es/docs/ecosistema-presencial/additional-content/your-integrations/notifications/webhooks).

> WARNING
>
> Importante
>
> Para configurar las notificaciones de Ecosistema Presencial, deberás utilizar el evento **Integraciones Presenciales**. Por medio de este evento recibirás las notificaciones de estados finales de los intent, ya sean procesados por Point o QR en modo integrado.


A continuación, te mostramos un ejemplo de notificación que puedes recibir para un dispositivo Point cuando un intent llega a un estado (`status`) final. Ten en cuenta que la información que se notifica dentro del nodo `data` va a depender de la información con la que se cree el intent.

``` json
{
"action": "topic_instore_integration_wh.application.authorized",
"api_version": "v1",
"data": {
"enabler_configuration": {
"ticket_number": "Ticket001",
"device_payment_mode": "CARD",
"print_on_terminal": [
"SELLER_TICKET"
]
},
"external_reference": "123132342341",
"id": "1234567-12345-12345678-1234567890",
"operations": [
{
"amount": "10.14",
"type": "PURCHASE"
}
],
"status": "CANCELED",
"url": "https://api.mercadopago.com/instore-api/integrations/v1/intents/1234567-12345-12345678-1234567890/point"
},
"date_created": "2023-07-27 20:24:21.776642198-0400",
"id": "1234567-12345-12345678-1234567890",
"live_mode": true,
"type": "topic_instore_integration_wh",
"user_id": 12345667
}

```
421 changes: 205 additions & 216 deletions guides/ecosistema-presencial/create-and-manage-intent-qr.es.md

Large diffs are not rendered by default.

1 change: 0 additions & 1 deletion guides/ecosistema-presencial/create-app.es.md
Original file line number Diff line number Diff line change
@@ -33,6 +33,5 @@ Además, en el menú ubicado del lado izquierdo del panel de información genera

| Tipo de información | Definición |
|---|---|
| PRUEBAS > Credenciales de prueba | Utiliza las [credenciales](/developers/es/docs/ecosistema-presencial/additional-content/your-integrations/credentials) de prueba para probar tus integraciones. Pueden combinarse con tarjetas de prueba para simular transacciones y verificar el correcto funcionamiento de las integraciones. En esta<br>sección encontrarás tu `access_token` de prueba. |
| NOTIFICACIÓN > Webhooks | Webhook (también conocido como devolución de llamada web) es un método simple que facilita que una aplicación o sistema proporcione información en tiempo real cada vez que ocurre un evento. Aquí podrás configurar una URL a la cual será notificado el estado final de los `intent`. |
| PRODUCCIÓN > Credenciales de producción | Utiliza las [credenciales](/developers/es/docs/ecosistema-presencial/additional-content/your-integrations/credentials) de producción para recibir pagos. Aquí encontrarás tu `access_token` productivo. |
9 changes: 7 additions & 2 deletions guides/ecosistema-presencial/enable-pdv.es.md
Original file line number Diff line number Diff line change
@@ -2,6 +2,13 @@

# Activar el modo PDV en el dispositivo Point

> WARNING
>
> Importante
>
> Este paso sólo es necesario para integrar dispositivos Point.

Para activar el modo PDV en tu dispositivo Point, primero tendrás que identificarlo. Para esto, deberás realizar una solicitud GET a la API [https://api.mercadopago.com/instore-api/point/v1/devices?offset=0&limit=50]():

> Esta solicitud retornará como respuesta los dispositivos asociados a la cuenta de Mercado Pago. Si en el listado te aparecen varios dispositivos, puedes identificar el Point que deseas por medio de los últimos caracteres del campo `id`. Los últimos números de este valor deben coincidir con el serial que aparece en la etiqueta trasera del dispositivo Point con el que estás integrando.
@@ -16,6 +23,4 @@ Por último, reinicia el dispositivo Point. Cuando se reactive, verás en la pan
>
> Ten en cuenta que sólo se permite un único dispositivo en modo PDV por caja.


------------
4 changes: 2 additions & 2 deletions guides/ecosistema-presencial/integration-configuration.es.md
Original file line number Diff line number Diff line change
@@ -4,5 +4,5 @@ Para comenzar a integrar el ecosistema presencial, deberás tener configurada tu

1. [Crear una aplicación en Tus Integraciones](/developers/es/docs/ecosistema-presencial/integration-configuration/create-app)
2. [Crear el local y la caja](/developers/es/docs/ecosistema-presencial/integration-configuration/create-store-point-of-sale)
3. [Iniciar sesión en un dispositivo Point](/developers/es/docs/ecosistema-presencial/integration-configuration/signin-point)
4. [Activar el modo PDV en el dispositivo](/developers/es/docs/ecosistema-presencial/integration-configuration/enable-pdv)
3. Si quieres integrar con Point, deberás [iniciar sesión en un dispositivo Point](/developers/es/docs/ecosistema-presencial/integration-configuration/signin-point)
4. Si ya iniciaste sesión, deberás [activar el modo PDV en el dispositivo](/developers/es/docs/ecosistema-presencial/integration-configuration/enable-pdv)
6 changes: 4 additions & 2 deletions guides/ecosistema-presencial/payments-processing.es.md
Original file line number Diff line number Diff line change
@@ -2,7 +2,9 @@

Un intent es una intención de pago que contiene los detalles de la transacción a realizarse. El intent debe ser creado para que esta transacción pueda procesarse.

> Previo a la creación de un intent, recomendamos crear [cuentas de prueba](developpers/es/docs/ecosistema-presencial/additional-content/your-integrations/test/accounts) para poder testear el correcto funcionamiento de tu integración y los flujos de pago.
Puedes ver cómo crear y administrar un intent siguiendo los enlaces a continuación:

* [Crear y administrar un intent en dispositivos Point](/developers/es/docs/ecosistema-presencial/payments-processing/create-and-manage-intent-point)
* [Crear y administrar un intent para QR](/developers/es/docs/ecosistema-presencial/payments-processing/create-and-manage-intent-qr)
* [Crear y administrar un intent en dispositivos Point](/developers/es/docs/ecosistema-presencial/payments-processing/create-and-manage-intent/point)
* [Crear y administrar un intent para QR](/developers/es/docs/ecosistema-presencial/payments-processing/create-and-manage-intent/qr)
4 changes: 2 additions & 2 deletions guides/ecosistema-presencial/prerequisites.es.md
Original file line number Diff line number Diff line change
@@ -3,7 +3,7 @@
| Requisito | Descripción |
|:---:|---|
| Cuenta de vendedor Mercado Pago | Para integrar la API de Ecosistema Presencial, necesitas una cuenta de vendedor en Mercado Pago. Si no tienes una, puedes [crearla](https://www.mercadopago[FAKER][URL][DOMAIN]/hub/registration/landing) de manera gratuita. |
| Aplicación Mercado Pago | En conjunto con el dispositivo, es necesario contar con la aplicación Mercado Pago para gestionar los cobros realizados. Puedes descargar su versión para [dispositivos Android](https://play.google.com/store/apps/details?id=com.mercadopago.wallet&hl=es_419), o bien para [dispositivos iOS](https://apps.apple.com/ar/app/mercado-pago/id925436649). |
| Aplicación Mercado Pago | Es necesario contar con la aplicación Mercado Pago para gestionar los cobros realizados. Puedes descargar su versión para [dispositivos Android](https://play.google.com/store/apps/details?id=com.mercadopago.wallet&hl=es_419), o bien para [dispositivos iOS](https://apps.apple.com/ar/app/mercado-pago/id925436649). |
| Credenciales | Contraseñas exclusivas utilizadas para identificar una integración en tu cuenta y que permiten la navegación segura y la protección de datos de los usuarios. Consulta la [documentación de Credenciales](/developers/es/docs/ecosistema-presencial/additional-content/your-integrations/credentials) para obtener más información. |
| Cuentas de prueba | Las cuentas de prueba te permiten realizar testeos en la aplicación para corroborar que todo está funcionando correctamente. Las puedes crear en [Tus Integraciones](/developers/panel/app). |
| Dispositivo Point | Para integrar la API de Ecosistema Presencial, es necesario adquirir la máquina. Los dispositivos soportados son:<br><br> ----[mla]---- Point Plus (POS) y [Point Smart](https://www.mercadopago.com.ar/point/invite?device=29&code=POINT_ORG) .------------ <br><br> ----[mlb]---- [Point Pro 2](https://www.mercadopago.com.br/point/invite?device=28&code=POINT_ORG&pog=true) .------------ <br><br> ----[mlm]---- [Point Smart](https://www.mercadopago.com.mx/point/invite?device=30&code=POINT_ORG) .------------ <br><br>Puedes conocer sus especificidades y comprar uno, si aún no lo has hecho, accediendo a la [tienda oficial](https://www.mercadopago[FAKER][URL][DOMAIN]/herramientas-para-vender/lectores-point). |
| Dispositivo Point | Para integrar la API de Ecosistema Presencial, es necesario adquirir la máquina. Los dispositivos soportados son:<br> ----[mla]---- Point Plus (POS) y [Point Smart](https://www.mercadopago.com.ar/point/invite?device=29&code=POINT_ORG) .------------ ----[mlb]---- [Point Pro 2](https://www.mercadopago.com.br/point/invite?device=28&code=POINT_ORG&pog=true) .------------ ----[mlm]---- [Point Smart](https://www.mercadopago.com.mx/point/invite?device=30&code=POINT_ORG) .------------ <br>Puedes conocer sus especificidades y comprar uno, si aún no lo has hecho, accediendo a la [tienda oficial](https://www.mercadopago[FAKER][URL][DOMAIN]/herramientas-para-vender/lectores-point). |
6 changes: 6 additions & 0 deletions guides/ecosistema-presencial/signin-point.es.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,12 @@
----[mla, mlb, mlm]----
# Iniciar sesión en un dispositivo Point

> WARNING
>
> Importante
>
> Este paso sólo es necesario para integrar dispositivos Point.
Para iniciar sesión en tu dispositivo Point, ingresa a la app de Mercado Pago desde tu móvil con tu usuario y contraseña.

Luego, todavía desde la app de Mercado Pago en tu móvil, escanea el código QR que aparece en la pantalla de tu Point.