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

Feature/ordem-unificada-api #2442

Open
wants to merge 44 commits into
base: development
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
44 commits
Select commit Hold shift + click to select a range
f5ccbdb
7
hgaldino Oct 15, 2024
040f500
doc
hgaldino Oct 17, 2024
0802910
doc1
hgaldino Oct 17, 2024
9bc0f0a
adding refunds and capture order endpoints
pcanosa Oct 17, 2024
50e301c
doc2
hgaldino Oct 17, 2024
fc79d9d
Merge branch 'feature/ordem-unificada-api' of github.com:mercadopago/…
hgaldino Oct 17, 2024
00648ef
Merge branch 'development' of github.com:mercadopago/devsite-docs int…
hgaldino Oct 17, 2024
5460d9c
docs3
hgaldino Oct 17, 2024
2ce7e30
docs4
hgaldino Oct 17, 2024
58891ff
docs5
hgaldino Oct 17, 2024
c5ef70b
fixing parameters json
pcanosa Oct 17, 2024
095f6f6
Merge branch 'development' of github.com:mercadopago/devsite-docs int…
hgaldino Oct 17, 2024
63820e9
docs6
hgaldino Oct 18, 2024
ddf1834
docs7
hgaldino Oct 19, 2024
3f2ec89
docs8
hgaldino Oct 19, 2024
4936ab9
docs9
hgaldino Oct 19, 2024
22aeefa
docs10
hgaldino Oct 19, 2024
e20e243
docs11
hgaldino Oct 21, 2024
5569212
docs12
hgaldino Oct 21, 2024
a1747b7
fixing capture y refund endpoints
pcanosa Oct 21, 2024
007f97b
fixes beta en landings, introduction y prerequisites
pcanosa Oct 22, 2024
74ddeda
adding reference_id description
pcanosa Oct 23, 2024
75d20f5
1
hgaldino Oct 24, 2024
1d8a800
2
hgaldino Oct 24, 2024
4fa4b39
Merge branch 'feature/order-api-point' of github.com:mercadopago/devs…
hgaldino Oct 24, 2024
afa5300
doc12
hgaldino Oct 24, 2024
d640994
doc13
hgaldino Oct 24, 2024
1299c4e
docs13
hgaldino Oct 24, 2024
fe63d2a
docs13
hgaldino Oct 24, 2024
7e70134
docs14
hgaldino Oct 24, 2024
fcd7e53
docs14
hgaldino Oct 24, 2024
861ce70
fixes beta
pcanosa Oct 25, 2024
f5afead
ajustes
hgaldino Oct 25, 2024
5db8798
ajuste 25/10
hgaldino Oct 25, 2024
5b1179a
redacción alternativa de docus de prueba
pcanosa Oct 25, 2024
5d683e2
fixes en payment manegement, reserve y cancellations
pcanosa Oct 28, 2024
ece0875
docs15
hgaldino Oct 28, 2024
92b642a
docs16
hgaldino Oct 28, 2024
e4f268a
fixes reserve, capture-cancel
pcanosa Nov 1, 2024
5483a49
heits
hgaldino Nov 5, 2024
ab91529
primeros fixes en terminals
pcanosa Nov 6, 2024
4f8edee
Merge branch 'development' of github.com:mercadopago/devsite-docs int…
hgaldino Nov 6, 2024
d149c11
Merge branch 'feature/order-api-point' of github.com:mercadopago/devs…
hgaldino Nov 6, 2024
0754253
inclusao das novas sessoes de menu
hgaldino Nov 8, 2024
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
1 change: 1 addition & 0 deletions guides/order/in-store-payments/introduction.en.md
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
# In-store payments
1 change: 1 addition & 0 deletions guides/order/in-store-payments/introduction.es.md
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
# Pagos presenciales
1 change: 1 addition & 0 deletions guides/order/in-store-payments/introduction.pt.md
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
# Pagamentos presenciais
3 changes: 3 additions & 0 deletions guides/order/in-store-payments/prerequisites.en.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# Prerequisites

To integrate Point
3 changes: 3 additions & 0 deletions guides/order/in-store-payments/prerequisites.es.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# Requisitos previos

Para integrar Point
3 changes: 3 additions & 0 deletions guides/order/in-store-payments/prerequisites.pt.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# Requisitos prévios

Para integrar Point
40 changes: 40 additions & 0 deletions guides/order/integration-errors.en.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,40 @@
# Possible errors

## Integration errors

| Code | Description | Description |
| --- | --- | --- |
| 205 | parameter cardNumber can not be null/empty | Enter card number. |
| 208 | parameter expirationMonth can not be null/empty | Select month. |
| 209 | parameter expirationYear can not be null/empty | Select year. |
| 212 | parameter docType can not be null/empty | Enter your ID type. |
| 213 | The parameter cardholder.document.subtype can not be null or empty | Enter your ID. |
| 214 | parameter docNumber can not be null/empty | Enter your ID. |
| 220 | parameter cardIssuerId can not be null/empty | Enter your bank. |
| 221 | parameter cardholderName can not be null/empty | Enter name and surname. |
| 224 | parameter securityCode can not be null/empty | Enter security code. |
| E203 | invalid parameter securityCode | Check security code. |
| E301 | invalid parameter cardNumber | Enter a valid card number. |
| 316 | invalid parameter cardholderName | Enter a valid name. |
| 322 | invalid parameter docType | Invalid ID type. |
| 323 | invalid parameter cardholder.document.subtype | Check your ID. |
| 324 | invalid parameter docNumber | Invalid ID. |
| 325 | invalid parameter expirationMonth | Invalid month. |
| 326 | invalid parameter expirationYear | Invalid year. |
| default | Another error code | Check data. |

## Card token generation errors

| Status | `status_detail` | Description |
| --- | --- | --- |
| 106 | Cannot operate between users from different countries | You cannot make payments to other countries. |
| 109 | Invalid number of shares for this `payment_method_id` | `payment_method_id` does not process payments in `installments` installments.<br/><br/>Select a different card or payment method. |
| 126 | The action requested is not valid for the current payment state | Your payment couldn't be processed. |
| 129 | Cannot pay this amount with this paymentMethod | `payment_method_id` does not process payments for the selected amount.<br/><br/>Select a different card or payment method. |
| 145 | Invalid users involved | You are trying to make a payment to a test user and a real user. |
| 150 | The `payer_id` cannot do payments currently | You cannot make payments. |
| 151 | The `payer_id` cannot do payments with this payment_method_id | You cannot make payments. |
| 160 | Collector not allowed to operate | Your payment couldn't be processed. |
| 204 | Unavailable `payment_method` | `payment_method_id` is not available right now.<br/><br/>Select a different card or payment method. |
| 801 | Already posted the same request in the last minute | You made a similar payment a while ago.<br/><br/>Try again in a few minutes. |
| default | Another error code | Your payment couldn't be processed. |
40 changes: 40 additions & 0 deletions guides/order/integration-errors.es.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,40 @@
# Posibles errores

## Errores de integración

| Código | Descripción | Descripción |
| --- | --- | --- |
| 205 | parameter cardNumber can not be null/empty | Ingresa el número de tu tarjeta. |
| 208 | parameter expirationMonth can not be null/empty | Elige un mes. |
| 209 | parameter expirationYear can not be null/empty | Elige un año. |
| 212 | parameter docType can not be null/empty | Ingresa tu tipo de documento. |
| 213 | The parameter cardholder.document.subtype can not be null or empty | Ingresa tu documento. |
| 214 | parameter docNumber can not be null/empty | Ingresa tu documento. |
| 220 | parameter cardIssuerId can not be null/empty | Ingresa tu banco. |
| 221 | parameter cardholderName can not be null/empty | Ingresa el nombre y apellido. |
| 224 | parameter securityCode can not be null/empty | Ingresa el código de seguridad. |
| E203 | invalid parameter securityCode | Revisa el código de seguridad. |
| E301 | invalid parameter cardNumber | Ingresa un número de tarjeta válido. |
| 316 | invalid parameter cardholderName | Ingresa un nombre válido. |
| 322 | invalid parameter docType | El tipo de documento es inválido. |
| 323 | invalid parameter cardholder.document.subtype | Revisa tu documento. |
| 324 | invalid parameter docNumber | El documento es inválido. |
| 325 | invalid parameter expirationMonth | El mes es inválido. |
| 326 | invalid parameter expirationYear | El año es inválido. |
| default | Otro código de error | Revisa los datos. |

## Errores en la creación del token de tarjeta

| Estado | `status_detail` | Descripción |
| --- | --- | --- |
| 106 | Cannot operate between users from different countries | No puedes realizar pagos a otros países. |
| 109 | Invalid number of shares for this `payment_method_id` | `payment_method_id` no procesa pagos en `installments` cuotas.<br/><br/>Elige otra tarjeta u otro medio de pago. |
| 126 | The action requested is not valid for the current payment state | No pudimos procesar tu pago. |
| 129 | Cannot pay this amount with this paymentMethod | `payment_method_id` no procesa pagos del monto seleccionado.<br/><br/>Elige otra tarjeta u otro medio de pago. |
| 145 | Invalid users involved | Una de las partes con la que intentas hacer el pago es de prueba y la otra es usuario real. |
| 150 | The `payer_id` cannot do payments currently | No puedes realizar pagos. |
| 151 | The `payer_id` cannot do payments with this payment_method_id | No puedes realizar pagos. |
| 160 | Collector not allowed to operate | No pudimos procesar tu pago. |
| 204 | Unavailable `payment_method` | `payment_method_id` no está disponible en este momento.<br/><br/>Elige otra tarjeta u otro medio de pago. |
| 801 | Already posted the same request in the last minute | Realizaste un pago similar hace instantes.<br/><br/>Intenta de nuevo en unos minutos. |
| default | Otro código de error | No pudimos procesar tu pago. |
38 changes: 38 additions & 0 deletions guides/order/integration-errors.pt.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,38 @@
# Possíveis erros

## Erros da integração

| Código | Descrição | Descrição |
| --- | --- | --- |
| 205 | parameter cardNumber can not be null/empty | Digite o número do seu cartão. |
| 208 | parameter expirationMonth can not be null/empty | Escolha um mês. |
| 209 | parameter expirationYear can not be null/empty | Escolha um ano. |
| 212 | parameter identificationType can not be null/empty | Informe seu documento. |
| 214 | parameter identificationNumber can not be null/empty | Informe seu documento. |
| 220 | parameter cardIssuerId can not be null/empty | Informe seu banco emissor. |
| 221 | parameter cardholderName can not be null/empty | Digite o nome e sobrenome. |
| 224 | parameter securityCode can not be null/empty | Digite o código de segurança. |
| E203 | invalid parameter securityCode | Confira o código de segurança. |
| E301 | invalid parameter cardNumber | Há algo de errado com esse número. Digite novamente. |
| 316 | invalid parameter cardholderName | Por favor, digite um nome válido. |
| 322 | invalid parameter identificationType | Confira seu documento. |
| 324 | invalid parameter identificationNumber | Confira seu documento. |
| 325 | invalid parameter expirationMonth | Confira a data. |
| 326 | invalid parameter expirationYear | Confira a data. |
| default | Outro código de erro | Confira os dados. |

## Erros na criação do token do cartão

| Status | `status_detail` | Descrição |
| --- | --- | --- |
| 106 | Cannot operate between users from different countries | Não pode efetuar pagamentos a usuários de outros países. |
| 109 | Invalid number of shares for this payment_method_id | O `payment_method_id` não processa pagamentos parcelados. <br> Escolha outro cartão ou outra forma de pagamento. |
| 126 | The action requested is not valid for the current payment state | Não conseguimos processar seu pagamento. |
| 129 | Cannot pay this amount with this paymentMethod | O `payment_method_id` não processa pagamentos para o valor selecionado. <br> Escolha outro cartão ou outra forma de pagamento. |
| 145 | Invalid users involved | Uma das partes com a qual está tentando realizar o pagamento é um usuário de teste e a outra é um usuário real. |
| 150 | The payer_id cannot do payments currently | Você não pode efetuar pagamentos. |
| 151 | The payer_id cannot do payments with this payment_method_id | Você não pode efetuar pagamentos. |
| 160 | Collector not allowed to operate | Não conseguimos processar seu pagamento. |
| 204 | Unavailable payment_method | O `payment_method_id` não está disponível nesse momento. <br> Escolha outro cartão ou outra forma de pagamento. |
| 801 | Already posted the same request in the last minute | Você realizou um pagamento similar há poucos instantes. <br> Tente novamente em alguns minutos. |
| default | Outro código de erro | Não pudemos processar seu pagamento. |
88 changes: 88 additions & 0 deletions guides/order/landing.en.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,88 @@
---
content_section_with_media:
- title: Order
- message: Order is an API designed to simplify the integration of Mercado Pago's payment products, allowing developers to access various payment solutions through a single integration. This unified API encompasses all payment methods offered by the platform, including QR Code payments, Point devices, and online payments.
- media_image: /order/landing-1.png
---

--- mini_landing_separator ---

>>>> Integration models <<<<

---
future_product_avaible:
- card_avaible: true
- card_icon: Card
- card_title: Online payments
- card_description: Build the payment processor for your website. You control the entire experience, from basic to advanced settings.
- card_button: /developers/en/docs/order/online-payments/introduction
- card_buttonDescription: Learn more
- card_pillText: AVAILABLE
- card_linkAvailable: false
- card_linkProof:
- card_linkProofDescription:
- card_linkAvailable: true
- card_avaible: true
- card_icon: User
- card_title: In-store payments
- card_description: XXX
- card_button: /developers/en/docs/order/in-store-payments/introduction
- card_buttonDescription: Learn more
- card_pillText: AVAILABLE
- card_linkAvailable: false
- card_linkProof:
- card_linkProofDescription:
---

--- mini_landing_separator ---

>>>> Availability by country <<<<
---
available_countries: mla, mlb, mlm

---

---
bullet_section_with_media:
- title: Advantages
- type: normal
- message: By centralizing these options into a single access point, implementation for integrators is easier, enabling them to offer multiple payment experiences without the need to work with several separate APIs. Check the table below for the main differences between the new Order API and the old Payments API.
- image: /order/landing-2.png
---

| Functionality | Payments API | Order API |
| --- | --- |--- |
| Mode | Automatic | Automatic and manual |
| Operations | Payments | [Payments](/developers/en/docs/order/online-payments/introduction) and [In-store][In-store](/developers/en/docs/order/in-store-payments/introduction) (QR and Point)|
| Multiple transactions | Not supported | Supported |
| Sending metadata | Allowed | Not allowed |
| Sending Notification URL | Allows in the payload. | Does not allow in the payload and must be configured in the [Developer panel > Application details](/developers/en/docs/order/additional-content/your-integrations/application-details). |
| Validations with complete error responses | Validates one error at a time. | Returns a list of all errors. |
| Return of PII data | Returns in some scenarios (e.g., approved). | Does not return in any scenario. |

--- mini_landing_separator ---

>>>> Accepted payment types <<<<

----[mlb]----

---
available_payments: credit, debit

---
------------
----[mla]----

---
available_payments: credit, debit

----
------------
----[mlm]----

---
available_payments: credit, debit

----

------------
88 changes: 88 additions & 0 deletions guides/order/landing.es.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,88 @@
---
content_section_with_media:
- title: Order
- message: Order es una API diseñada para simplificar la integración de los productos de pago de Mercado Pago, que permite que los desarrolladores accedan a diversas soluciones de pago mediante una única integración. Esta API unificada abarca todos los métodos de pago ofrecidos por la plataforma, incluyendo pagos con Código QR, dispositivos Point y pagos online.
- media_image: /order/landing-1.png
---

--- mini_landing_separator ---

>>>> Modelos de integración <<<<

---
future_product_avaible:
- card_avaible: true
- card_icon: Card
- card_title: Pagos online
- card_description: Construye el procesador de pagos para tu sitio web. Tú controlas toda la experiencia, desde configuraciones básicas hasta avanzadas.
- card_button: /developers/es/docs/order/online-payments/introduction
- card_buttonDescription: Saber más
- card_pillText: DISPONIBLE
- card_linkAvailable: false
- card_linkProof:
- card_linkProofDescription:
- card_linkAvailable: true
- card_avaible: true
- card_icon: User
- card_title: Pagos presenciales
- card_description: XXX
- card_button: /developers/es/docs/order/in-store-payments/introduction
- card_buttonDescription: Saber más
- card_pillText: DISPONIBLE
- card_linkAvailable: false
- card_linkProof:
- card_linkProofDescription:
---

--- mini_landing_separator ---

>>>> Disponibilidad por país <<<<
---
available_countries: mla, mlb, mlm

---

---
bullet_section_with_media:
- title: Ventajas
- type: normal
- message: Al centralizar estas opciones en un solo punto de acceso, se facilita la implementación para los integradores, quienes pueden ofrecer múltiples experiencias de pago sin la necesidad de trabajar con varias APIs separadas. Ve en la tabla a continuación las principales diferencias entre la nueva API de Order y la antigua API de Pagos.
- image: /order/landing-2.png
---

| Funcionalidad | API de Pagos | API de Order |
| --- | --- |--- |
| Modo | Automático | Automático y manual |
| Operaciones | Payments | [Payments](/developers/es/docs/order/online-payments/introduction) e [In-store](/developers/es/docs/order/in-store-payments/introduction) (QR y Point)|
| Múltiples transacciones | No tiene | Tiene |
| Envío de metadatos | Permite | No permite |
| Envío de Notification URL | Permite en el _payload_ | No permite en el _payload_ y debe ser configurado en el [Panel del desarrollador > Detalles de la aplicación](/developers/es/docs/order/additional-content/your-integrations/application-details). |
| Validaciones con respuestas de errores completas | Valida un error a la vez. | Retorna una lista con todos los errores. |
| Retorno de datos PII | Retorna en algunos escenarios (ej: aprobado). | No retorna en ningún escenario. |

--- mini_landing_separator ---

>>>> Tipos de pago aceptados <<<<

----[mlb]----

---
available_payments: credit, debit

---
------------
----[mla]----

---
available_payments: credit, debit

----
------------
----[mlm]----

---
available_payments: credit, debit

----

------------
Loading