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

Conversation

pcanosa
Copy link
Collaborator

@pcanosa pcanosa commented Jul 31, 2023

Description

Documentación de la nueva API Ecosistema Presencial para MLA y MLB, donde coinciden Point y QR.

Co-authored-by: Pierre Etienne Pradere Palacios <etienne.pradere@mercadolibre.com.co>
Comment on lines +29 to +53
{
"description": "description",
"external_reference": "external_reference",
"status": "CLOSED",
"operations": [
{
"type": "PURCHASE",
....
"results": [
{
"id": 123456,
"source": "PAYMENT"
}
]
...
}
],
"enabler_configuration": {
"ticket_number": "Ticket001",
"device_payment_mode": "CARD",
"print_on_terminal": [
"SELLER_TICKET"
]
}
}

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
{
"description": "description",
"external_reference": "external_reference",
"status": "CLOSED",
"operations": [
{
"type": "PURCHASE",
....
"results": [
{
"id": 123456,
"source": "PAYMENT"
}
]
...
}
],
"enabler_configuration": {
"ticket_number": "Ticket001",
"device_payment_mode": "CARD",
"print_on_terminal": [
"SELLER_TICKET"
]
}
}
{
"id": "<uuid>",
"status": "closed",
"configuration": {
"integration": {
"device_id": "INGENICO_MOVE2500__ING-ARG-12345",
"notification_url": "https://webhook.site/1235"
},
"options": {
"ticket_number":"ticket01",
"print_on_terminal": [
"SELLER_TICKET"
]
}
},
"order": {
"amount": "11.00",
"description": "description-random",
"external_reference": "external-reference",
"payment": {
"credit_card": {
"payment_id": "1234",
"url": "https://api.mercadopago.com/v1/payments/1234"
}
}
}
}

}
```

Dentro del campo `status` podrás ver el estado del intent. Los únicos estados finales son `CANCELED`, `CLOSED`, `EXPIRED` , `ERROR` y `CONFIRMATION_REQUIRED`.
Copy link

@TatanMeli TatanMeli Sep 27, 2023

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Dentro del campo `status` podrás ver el estado del intent. Los únicos estados finales son `CANCELED`, `CLOSED`, `EXPIRED` , `ERROR` y `CONFIRMATION_REQUIRED`.
Dentro del campo `status` podrás ver el estado del intent. Los únicos estados finales son `canceled`, `closed`, `expired` , `failed` y `confirmation_required`.

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/instore-api/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.
Copy link

@TatanMeli TatanMeli Sep 27, 2023

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
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.
Ten en cuenta que, para el estado final `closed`, verás en la respuesta el nodo adicional `payment`. 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.

Comment on lines +65 to +66
| `id` | Es la identificación del pago. Con ella, puedes dirigirte a [Payments API](/developers/es/reference/payments/_payments_id/get) y consultar el estado final del pago. |
| `source` | Entidad a la que pertenece el `id`. Arrojará el valor `PAYMENT` cuando el flujo del pago se haya creado correctamente. Dirígete a [Payments API](/developers/es/reference/payments/_payments_id/get) para verificar el estado final del pago con el `id` recibido. |

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
| `id` | Es la identificación del pago. Con ella, puedes dirigirte a [Payments API](/developers/es/reference/payments/_payments_id/get) y consultar el estado final del pago. |
| `source` | Entidad a la que pertenece el `id`. Arrojará el valor `PAYMENT` cuando el flujo del pago se haya creado correctamente. Dirígete a [Payments API](/developers/es/reference/payments/_payments_id/get) para verificar el estado final del pago con el `id` recibido. |
| `payment_id` | Es la identificación del pago. Con ella, puedes dirigirte a [Payments API](/developers/es/reference/payments/_payments_id/get) y consultar el estado final del pago. |
| `url` | Url de la consulta hacia payments(/developers/es/reference/payments/_payments_id/get) para verificar el estado final del pago con el `payment_id ` recibido. |

>
> 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/instore-api/glossary).

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
> 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/instore-api/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/instore-api/glossary).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
6 participants