diff --git a/guides/order/integration-errors.en.md b/guides/order/integration-errors.en.md index e09005b071..3fc6fbf933 100644 --- a/guides/order/integration-errors.en.md +++ b/guides/order/integration-errors.en.md @@ -19,7 +19,7 @@ Check this list with all the possible errors that the API can return, and how to | Request Error | 400 | `invalid_order_mode_for_operation` | The reported mode is not valid for this operation. Verify if you are using the correct mode according to the desired operation. | | Request Error | 400 | `invalid_order_type` | The type of the order is invalid. Check if the type used is valid for the operation. | | Request Error | 400 | `invalid_transaction_id` | The transaction ID is invalid. Ensure that the ID is correct. | -| Request Error | 400 | `exceeded_number_of_transactions` | An error occurred in the request. The order accepts a maximum of two transactions. Remove the excess transactions.| +| Request Error | 400 | `exceeded_number_of_transactions` | An error occurred in the request. The Order accepts a maximum of one transaction. Remove the excess transactions.| | Request Error | 400 | `invalid_email_for_sandbox` | Email format is invalid for sandbox environment, must contains "@testuser.com". | | Processing error | 402 | `failed` | There was an error processing one of the transactions. Check the returned message for more information. | | Request Error | 404 | `order_not_found` | The order was not found. Check if the provided ID is correct. | diff --git a/guides/order/integration-errors.es.md b/guides/order/integration-errors.es.md index d13c4d2bc0..f4a239357b 100644 --- a/guides/order/integration-errors.es.md +++ b/guides/order/integration-errors.es.md @@ -19,7 +19,7 @@ Consulta la lista de posibles errores devueltos por la API y cómo corregirlos. | Error de solicitud | 400 | `invalid_order_mode_for_operation` | El modo informado no es válido para esta operación. Verifica si estás utilizando el modo correcto según la operación deseada. | | Error de solicitud | 400 | `invalid_order_type` | El tipo de la order es inválido. Verifica si el tipo utilizado es válido para la operación. | | Error de solicitud | 400 | `invalid_transaction_id` | El ID de la transacción es inválido. Asegúrate de que el ID es correcto. | -| Error de solicitud | 400 | `exceeded_number_of_transactions` | Ocurrió un error en la solicitud. La order acepta un máximo de dos transacciones. Elimine las transacciones excedentes. | +| Error de solicitud | 400 | `exceeded_number_of_transactions` | Ocurrió un error en la solicitud. La Order acepta un máximo de una transaccion. Elimine las transacciones excedentes. | | Error de solicitud | 400 | `invalid_email_for_sandbox` | El formato de correo electrónico no es válido para el entorno de *sandbox*, debe contener "@testuser.com". | | Error de procesamiento | 402 | `failed` | Hubo un error en el procesamiento de alguna de las transacciones. Verifica el mensaje devuelto para más información. | | Error de solicitud | 404 | `order_not_found` | La order no fue encontrada. Verifica si el ID informado es correcto. | diff --git a/guides/order/integration-errors.pt.md b/guides/order/integration-errors.pt.md index 9f6a430500..6a7f6526f3 100644 --- a/guides/order/integration-errors.pt.md +++ b/guides/order/integration-errors.pt.md @@ -19,7 +19,7 @@ Veja a lista de possíveis erros retornados pela API e como corrigi-los. | Erro de requisição | 400 | `invalid_order_mode_for_operation` | O modo informado não é valido para esta operação. Verifique se está utilizando o modo correto conforme a operação desejada. | | Erro de requisição | 400 | `invalid_order_type` | Tipo da order é invalido. Verifique se o tipo utilizado é valido para a operação. | | Erro de requisição | 400 | `invalid_transaction_id` | O ID da transação é invalido. Certifique-se de que o ID está correto. | -| Erro de requisição | 400 | `exceeded_number_of_transactions` | Ocorreu um erro na requisição. A order aceita, no máximo, duas transações. Remova as transações excedentes. | +| Erro de requisição | 400 | `exceeded_number_of_transactions` | Ocorreu um erro na requisição. A order aceita, no máximo, uma transação. Remova as transações excedentes. | | Erro de requisição | 400 | `invalid_email_for_sandbox` | O formato de e-mail é inválido para o ambiente de *sandbox*, deve conter "@testuser.com". | | Erro de processamento | 402 | `failed` | Ocorreu um erro no processamento de alguma das transações. Verifique a mensagem para mais informações. | | Erro de requisição | 404 | `order_not_found` | A order não foi encontrada. Verifique se o ID informado está correto. | diff --git a/guides/order/online-payments/prerequisites.pt.md b/guides/order/online-payments/prerequisites.pt.md index e6d5fea5af..cd26651e8c 100644 --- a/guides/order/online-payments/prerequisites.pt.md +++ b/guides/order/online-payments/prerequisites.pt.md @@ -5,7 +5,7 @@ Para integrar Order é importante atender aos requisitos mostrados abaixo. | Requisito | Descrição | | --- | --- | | Aplicação | As aplicações são as diferentes integrações contidas em uma ou mais lojas. Você pode criar uma aplicação para cada solução que implementar, a fim de ter tudo organizado e manter um controle que facilite a gestão. Veja [Suas integrações](/developers/pt/docs/order/additional-content/your-integrations/introduction) para mais informações sobre como criar uma aplicação. | -| Credenciais | As credenciais são chaves únicas que fornecemos para que você possa configurar as suas integrações. Você precisará de um par de credenciais de produção te para testar a integração e para receber pagamentos reais. Veja [Credenciais](/developers/pt/docs/order/additional-content/your-integrations/credentials) para mais informações. | +| Credenciais | As credenciais são chaves únicas que fornecemos para que você possa configurar as suas integrações. Você precisará de um par de credenciais de produção para testar a integração e para receber pagamentos reais. Veja [Credenciais](/developers/pt/docs/order/additional-content/your-integrations/credentials) para mais informações. | | MercadoPago.js | MercadoPago.js te permite gerenciar os dados do cartão para cumprir com os requerimentos de segurança necessários e evitar o envio de dados sensíveis para seus servidores. Para isso, nossa biblioteca gera um token que representa esta informação e te permite operar de forma segura. Veja [SDKs](/developers/pt/docs/sdks-library/client-side/mp-js-v2) para ter acesso ao MercadoPago.js. | ----[mlb]---- | Chave Pix | Caso queira oferecer pagamentos via Pix, é necessário ter as chaves cadastradas. Caso ainda não tenha, [clique aqui](https://www.youtube.com/watch?v=60tApKYVnkA) para mais informações sobre como cadastrá-las. | ------------ diff --git a/reference/api-json/order.json b/reference/api-json/order.json index 603f02e6ae..5c40796a97 100644 --- a/reference/api-json/order.json +++ b/reference/api-json/order.json @@ -44,17 +44,17 @@ "type": "object", "required": true, "description": { - "en": "Contains information about the transactions associated with the Order. It can contain up to 2 transactions. For example, if you want to create an Order with two cards, you can add another item to the array \"payments\" node, dividing the total value of the transaction and indicating a different payment method for each one of the items.", - "pt": "Contém informações sobre as transações associadas à Order. Pode conter até 2 transações. Por exemplo, se deseja criar uma Order com dois cartões, você pode adicionar um item ao array \"payments\", dividindo o valor total da transação e indicando uma forma de pagamento diferente em cada um dos itens do array.", - "es": "Contiene información sobre las transacciones asociadas a la Order. Puede contener hasta 2 transacciones. Por ejemplo, en caso de querer crear una Order con dos tarjetas, puedes agregar un ítem al array \"payments\", dividiendo el valor total de la transacción e indicando un método de pago distinto en cada uno de los ítems del array." + "en": "Contains information about the transactions associated with the Order. It can contain only one transaction.", + "pt": "Contém informações sobre as transações associadas à Order. Pode conter apenas uma transação.", + "es": "Contiene información sobre las transacciones asociadas a la Order. Puede contener solo una transacción." }, "properties": { "payments": { "type": "array", "description": { - "en": "Contains information about the payment Order. If you want to create an Order with two cards, you can add an item to the array, dividing the total value of the transaction and indicating a different payment method for each one.", - "pt": "Contém informações sobre a Order do pagamento. Caso deseje criar uma Order com dois cartões, você pode adicionar um item ao array, dividindo o valor total da transação e indicando um meio de pagamento diferente em cada item.", - "es": "Contiene información sobre la Order de pago. En caso de querer crear una Order con dos tarjetas, puedes agregar un ítem al array, dividiendo el monto de la transacción y señalando un medio de pago diferente en cada uno. " + "en": "Contains information about the payment Order.", + "pt": "Contém informações sobre a Order do pagamento.", + "es": "Contiene información sobre la Order de pago." }, "properties": { "amount": { @@ -206,7 +206,131 @@ "$ref": "#/components/schemas/create_order_transaction_status_detail" }, "payment_method": { - "$ref": "#/components/schemas/payment_method" + "type": "object", + "description": { + "en": "Information about the payment method. Access the endpoint '/v1/payment_methods' to check all available payment methods and get a list with the details of each one and their properties.", + "pt": "Informação sobre o meio de pagamento. Utilize o endpoint '/v1/payment_methods' para acessar a lista completa de meios de pagamento disponíveis. Esse recurso fornece detalhes sobre cada meio, incluindo suas propriedades.", + "es": "Información sobre el medio de pago. Accede al endpoint '/v1/payment_methods' para consultar todos los medios de pago disponibles y obtener una lista con los detalles de cada uno de ellos y sus propiedades." + }, + "properties":{ + "id": { + "type": "string", + "example": "visa", + "description": { + "en": "Identifier of the payment method selected to make the payment. If it's a card payment, it will show the brand.", + "pt": "Identificador do meio de pagamento selecionado para efetuar o pagamento. Caso seja um pagamento com cartão, indicará a bandeira.", + "es": "Identificador del medio de pago seleccionado para realizar el pago. En caso de ser un pago con tarjeta, indicará la bandera." + } + }, + "type": { + "type": "string", + "example": "credit_card", + "description": { + "en": "Type of payment method selected to make the payment.", + "pt": "Tipo de meio de pagamento selecionado para efetuar o pagamento.", + "es": "Tipo de medio de pago seleccionado para realizar el pago." + } + }, + "token": { + "type": "string", + "example": "12345", + "description": { + "en": "It is a mandatory field for card payments, as it is the token that identifies the card and contains its data securely. It has a minimum length of 32 characters, and a maximum length of 33. If you don't know how to generate it, go to the card payment configuration in the Checkout API documentation.", + "pt": "É um campo obrigatório para pagamentos com cartão, pois é o token que identifica o cartão e contém seus dados de forma segura. Possui comprimento mínimo de 32 caracteres e máximo de 33. Caso não saiba como gerá-lo, acesse a configuração de pagamento com cartão na documentação do Checkout Transparente.", + "es": "Es un campo obligatorio para los pagos con tarjeta, pues se trata del token que la identifica y contiene sus datos de forma segura. Tiene una longitud mínima de 32 caracteres, y una longitud máxima de 33. Si desconoces cómo generarlo, dirígete a la configuración de pagos con tarjeta en la documentación de Checkout API." + } + }, + "installments": { + "type": "integer", + "example": 1, + "description": { + "pt": "Número de parcelas selecionado.", + "en": "Number of installments selected.", + "es": "Cantidad de cuotas seleccionada." + } + }, + "statement_descriptor": { + "type": "string", + "example": "approved", + "description": { + "en": "Description that the payment will appear with in the card statement.", + "pt": "Descrição com a qual o pagamento aparecerá na fatura do cartão.", + "es": "Descripción con la que aparecerá el pago en el resumen de tarjeta." + } + }, + "ticket_url": { + "type": "string", + "example": "https://www.mercadopago.com.ar/payments/86797024510/ticket?caller_id=1870026883&payment_method_id=rapipago&payment_id=86797024510&payment_method_reference_id=6004835002&hash=0331521a-9ddb-44a2-851c-65f77d8d394e", + "description": { + "en": "Ticket URL. It is returned for offline payment methods, such as rapipago, pagofacil, bolbradesco, oxxo, paycash, banamex, bancomer, clabe, pix.", + "pt": "URL do ticket. É retornado para meios de pagamento offline, como rapipago, pagofacil, bolbradesco, oxxo, paycash, banamex, bancomer, clabe, pix.", + "es": "URL del ticket. Se devuelve para métodos de pago offline, como rapipago, pagofacil, bolbradesco, oxxo, paycash, banamex, bancomer, clabe, pix." + } + }, + "barcode_content": { + "type": "string", + "example": "3335008800000000006004835002100020000242462010", + "description": { + "en": "Barcode content. It is returned for offline payment methods, such as rapipago, pagofacil, bolbradesco, oxxo, paycash.", + "pt": "Conteúdo do código de barras. É retornado para meios de pagamento offline, como rapipago, pagofacil, bolbradesco, oxxo, paycash.", + "es": "Contenido del código de barras. Se devuelve para métodos de pago offline, como rapipago, pagofacil, bolbradesco, oxxo, paycash." + } + }, + "reference": { + "type": "string", + "example": "6005407530", + "description": { + "en": "Reference number. It is returned for offline payment methods, such as rapipago, pagofacil, bolbradesco, oxxo, paycash, banamex, bancomer, clabe.", + "pt": "Número de referência. É retornado para meios de pagamento offline, como rapipago, pagofacil, bolbradesco, oxxo, paycash, banamex, bancomer, clabe.", + "es": "Número de referencia. Se devuelve para métodos de pago offline, como rapipago, pagofacil, bolbradesco, oxxo, paycash, banamex, bancomer, clabe." + } + }, + "verification_code": { + "type": "string", + "example": "6005407530", + "description": { + "en": "Verification code. It is returned for offline payment methods, such as rapipago, pagofacil, bolbradesco, oxxo, paycash, banamex, bancomer.", + "pt": "Código de verificação. É retornado para meios de pagamento offline, como rapipago, pagofacil, bolbradesco, oxxo, paycash, banamex, bancomer.", + "es": "Código de verificación. Se devuelve para métodos de pago offline, como rapipago, pagofacil, bolbradesco, oxxo, paycash, banamex, bancomer." + } + }, + "financial_institution": { + "type": "string", + "example": "bolbradesco", + "description": { + "en": "Financial institution. It is returned for offline payment methods, such as bolbradesco, banamex, bancomer.", + "pt": "Instituição financeira. É retornado para meios de pagamento offline, como bolbradesco, banamex, bancomer.", + "es": "Institución financiera. Se devuelve para métodos de pago offline, como bolbradesco, banamex, bancomer." + } + }, + "digitable_line": { + "type": "string", + "example": "23793380296060054351030006333303799140000020000", + "description": { + "en": "Digitable line. It is returned for offline payment method bolbradesco.", + "pt": "Linha digitável. É retornado para o meio de pagamento offline bolbradesco.", + "es": "Línea digitable. Se devuelve para el método de pago offline bolbradesco." + } + }, + "qr_code": { + "type": "string", + "example": "00020126580014br.gov.bcb.pix0136b76aa9c2-2ec4-4110-954e-ebfe34f05b61520400005303986540510.005802BR5912TESTPVBWOSBE6009Sao Paulo62240520mpqrinter715936942186304C3C0", + "description": { + "en": "QR code. It is returned for offline payment method pix.", + "pt": "Código QR. É retornado para o meio de pagamento offline pix.", + "es": "Código QR. Se devuelve para el método de pago offline pix." + } + }, + "qr_code_base64": { + "type": "string", + "example": "iVBORw0KGgoAAAANSUhEUgAABWQAAAVkAQAAAAB79i", + "description": { + "en": "QR code in base64. It is returned for offline payment method pix.", + "pt": "Código QR em base64. É retornado para o meio de pagamento offline pix.", + "es": "Código QR en base64. Se devuelve para el método de pago offline pix." + } + } + } } } } @@ -780,7 +904,304 @@ ] }, "payment_method": { - "$ref": "#/components/schemas/payment_method" + "type": "object", + "required": true, + "description": { + "en": "Information about the payment method. Access the endpoint '/v1/payment_methods' to check all available payment methods and get a list with the details of each one and their properties.", + "pt": "Informação sobre o meio de pagamento. Utilize o endpoint '/v1/payment_methods' para acessar a lista completa de meios de pagamento disponíveis. Esse recurso fornece detalhes sobre cada meio, incluindo suas propriedades.", + "es": "Información sobre el medio de pago. Accede al endpoint '/v1/payment_methods' para consultar todos los medios de pago disponibles y obtener una lista con los detalles de cada uno de ellos y sus propiedades." + }, + "properties": { + "id": { + "type": "string", + "example": "visa", + "description": { + "en": "Identifier of the payment method selected to make the payment. If it's a card payment, it will show the brand.", + "pt": "Identificador do meio de pagamento selecionado para efetuar o pagamento. Caso seja um pagamento com cartão, indicará a bandeira.", + "es": "Identificador del medio de pago seleccionado para realizar el pago. En caso de ser un pago con tarjeta, indicará la bandera." + }, + "enum": [ + { + "title": "visa", + "description": { + "en": "Visa credit card.", + "es": "Tarjeta de crédito Visa.", + "pt": "Cartão de crédito Visa." + } + }, + { + "title": "master", + "description": { + "en": "Master credit card.", + "es": "Tarjeta de crédito Master.", + "pt": "Cartão de crédito Master." + } + }, + { + "title": "debelo", + "description": { + "en": "Elo debit card.", + "es": "Tarjeta de débito Elo.", + "pt": "Cartão de débito Elo." + } + }, + { + "title": "debmaster", + "description": { + "en": "Master debit card.", + "es": "Tarjeta de débito Master.", + "pt": "Cartão de débito Master." + } + }, + { + "title": "debvisa", + "description": { + "en": "Visa debit card.", + "es": "Tarjeta de débito Visa.", + "pt": "Cartão de débito Visa." + } + }, + { + "title": "account_money", + "description": { + "en": "Money from the user's Mercado Pago account.", + "es": "Dinero de la cuenta de Mercado Pago del usuario.", + "pt": "Dinheiro da conta do Mercado Pago do usuário." + } + }, + { + "title": "rapipago", + "description": { + "en": "Rapipago payment.", + "es": "Pago en efectivo en Rapipago.", + "pt": "Pagamento em dinheiro no Rapipago." + } + }, + { + "title": "pagofacil", + "description": { + "en": "Pagofacil payment.", + "es": "Pago en efectivo en Pagofacil.", + "pt": "Pagamento em dinheiro no Pagofacil." + } + }, + { + "title": "bolbradesco", + "description": { + "en": "Ticket Bradesco payment.", + "es": "Pago con ticket Bradesco.", + "pt": "Pagamento com ticket Bradesco." + } + }, + { + "title": "oxxo", + "description": { + "en": "Oxxo payment.", + "es": "Pago en efectivo en Oxxo.", + "pt": "Pagamento em dinheiro no Oxxo." + } + }, + { + "title": "paycash", + "description": { + "en": "Paycash payment.", + "es": "Pago en efectivo en Paycash.", + "pt": "Pagamento em dinheiro no Paycash." + } + }, + { + "title": "bancomer", + "description": { + "en": "Bancomer payment.", + "es": "Pago en efectivo en Bancomer.", + "pt": "Pagamento em dinheiro no Bancomer." + } + }, + { + "title": "banamex", + "description": { + "en": "Banamex payment.", + "es": "Pago en efectivo en Banamex.", + "pt": "Pagamento em dinheiro no Banamex." + } + }, + { + "title": "clabe", + "description": { + "en": "Clabe payment.", + "es": "Pago con Clabe.", + "pt": "Pagamento com Clabe." + } + }, + { + "title": "pix", + "description": { + "en": "Pix payment.", + "es": "Pago con Pix.", + "pt": "Pagamento com Pix." + } + } + ] + }, + "type": { + "type": "string", + "example": "credit_card", + "description": { + "en": "Type of payment method selected to make the payment.", + "pt": "Tipo de meio de pagamento selecionado para efetuar o pagamento.", + "es": "Tipo de medio de pago seleccionado para realizar el pago." + }, + "enum": [ + { + "title": "credit_card", + "description": { + "en": "Credit card.", + "es": "Tarjeta de crédito.", + "pt": "Cartão de crédito." + } + }, + { + "title": "debit_card", + "description": { + "en": "Debit card.", + "es": "Tarjeta de débito.", + "pt": "Cartão de débito." + } + }, + { + "title": "account_money", + "description": { + "en": "Money from the user's Mercado Pago account.", + "es": "Dinero de la cuenta de Mercado Pago del usuario.", + "pt": "Dinheiro da conta do Mercado Pago do usuário." + } + }, + { + "title": "ticket", + "description": { + "en": "Cash payment.", + "es": "Pago en efectivo.", + "pt": "Pagamento em dinheiro." + } + }, + { + "title": "atm", + "description": { + "en": "ATM payment.", + "es": "Pago en cajero automático.", + "pt": "Pagamento em caixa eletrônico." + } + }, + { + "title": "bank_transfer", + "description": { + "en": "Bank transfer.", + "es": "Transferencia bancaria.", + "pt": "Transferência bancária." + } + } + ] + }, + "token": { + "type": "string", + "example": "12345", + "description": { + "en": "It is a mandatory field for card payments, as it is the token that identifies the card and contains its data securely. It has a minimum length of 32 characters, and a maximum length of 33. If you don't know how to generate it, go to the card payment configuration in the Checkout API documentation.", + "pt": "É um campo obrigatório para pagamentos com cartão, pois é o token que identifica o cartão e contém seus dados de forma segura. Possui comprimento mínimo de 32 caracteres e máximo de 33. Caso não saiba como gerá-lo, acesse a configuração de pagamento com cartão na documentação do Checkout Transparente.", + "es": "Es un campo obligatorio para los pagos con tarjeta, pues se trata del token que la identifica y contiene sus datos de forma segura. Tiene una longitud mínima de 32 caracteres, y una longitud máxima de 33. Si desconoces cómo generarlo, dirígete a la configuración de pagos con tarjeta en la documentación de Checkout API." + } + }, + "installments": { + "type": "integer", + "example": 1, + "description": { + "pt": "Número de parcelas selecionado.", + "en": "Number of installments selected.", + "es": "Cantidad de cuotas seleccionada." + } + }, + "statement_descriptor": { + "type": "string", + "example": "approved", + "description": { + "en": "Description that the payment will appear with in the card statement.", + "pt": "Descrição com a qual o pagamento aparecerá na fatura do cartão.", + "es": "Descripción con la que aparecerá el pago en el resumen de tarjeta." + } + }, + "ticket_url": { + "type": "string", + "example": "https://www.mercadopago.com.ar/payments/86797024510/ticket?caller_id=1870026883&payment_method_id=rapipago&payment_id=86797024510&payment_method_reference_id=6004835002&hash=0331521a-9ddb-44a2-851c-65f77d8d394e", + "description": { + "en": "Ticket URL. It is returned for offline payment methods, such as rapipago, pagofacil, bolbradesco, oxxo, paycash, banamex, bancomer, clabe, pix.", + "pt": "URL do ticket. É retornado para meios de pagamento offline, como rapipago, pagofacil, bolbradesco, oxxo, paycash, banamex, bancomer, clabe, pix.", + "es": "URL del ticket. Se devuelve para métodos de pago offline, como rapipago, pagofacil, bolbradesco, oxxo, paycash, banamex, bancomer, clabe, pix." + } + }, + "barcode_content": { + "type": "string", + "example": "3335008800000000006004835002100020000242462010", + "description": { + "en": "Barcode content. It is returned for offline payment methods, such as rapipago, pagofacil, bolbradesco, oxxo, paycash.", + "pt": "Conteúdo do código de barras. É retornado para meios de pagamento offline, como rapipago, pagofacil, bolbradesco, oxxo, paycash.", + "es": "Contenido del código de barras. Se devuelve para métodos de pago offline, como rapipago, pagofacil, bolbradesco, oxxo, paycash." + } + }, + "reference": { + "type": "string", + "example": "6005407530", + "description": { + "en": "Reference number. It is returned for offline payment methods, such as rapipago, pagofacil, bolbradesco, oxxo, paycash, banamex, bancomer, clabe.", + "pt": "Número de referência. É retornado para meios de pagamento offline, como rapipago, pagofacil, bolbradesco, oxxo, paycash, banamex, bancomer, clabe.", + "es": "Número de referencia. Se devuelve para métodos de pago offline, como rapipago, pagofacil, bolbradesco, oxxo, paycash, banamex, bancomer, clabe." + } + }, + "verification_code": { + "type": "string", + "example": "6005407530", + "description": { + "en": "Verification code. It is returned for offline payment methods, such as rapipago, pagofacil, bolbradesco, oxxo, paycash, banamex, bancomer.", + "pt": "Código de verificação. É retornado para meios de pagamento offline, como rapipago, pagofacil, bolbradesco, oxxo, paycash, banamex, bancomer.", + "es": "Código de verificación. Se devuelve para métodos de pago offline, como rapipago, pagofacil, bolbradesco, oxxo, paycash, banamex, bancomer." + } + }, + "financial_institution": { + "type": "string", + "example": "bolbradesco", + "description": { + "en": "Financial institution. It is returned for offline payment methods, such as bolbradesco, banamex, bancomer.", + "pt": "Instituição financeira. É retornado para meios de pagamento offline, como bolbradesco, banamex, bancomer.", + "es": "Institución financiera. Se devuelve para métodos de pago offline, como bolbradesco, banamex, bancomer." + } + }, + "digitable_line": { + "type": "string", + "example": "23793380296060054351030006333303799140000020000", + "description": { + "en": "Digitable line. It is returned for offline payment method bolbradesco.", + "pt": "Linha digitável. É retornado para o meio de pagamento offline bolbradesco.", + "es": "Línea digitable. Se devuelve para el método de pago offline bolbradesco." + } + }, + "qr_code": { + "type": "string", + "example": "00020126580014br.gov.bcb.pix0136b76aa9c2-2ec4-4110-954e-ebfe34f05b61520400005303986540510.005802BR5912TESTPVBWOSBE6009Sao Paulo62240520mpqrinter715936942186304C3C0", + "description": { + "en": "QR code. It is returned for offline payment method pix.", + "pt": "Código QR. É retornado para o meio de pagamento offline pix.", + "es": "Código QR. Se devuelve para el método de pago offline pix." + } + }, + "qr_code_base64": { + "type": "string", + "example": "iVBORw0KGgoAAAANSUhEUgAABWQAAAVkAQAAAAB79i", + "description": { + "en": "QR code in base64. It is returned for offline payment method pix.", + "pt": "Código QR em base64. É retornado para o meio de pagamento offline pix.", + "es": "Código QR en base64. Se devuelve para el método de pago offline pix." + } + } + } } } } @@ -1260,9 +1681,9 @@ "payments": { "type": "array", "description": { - "en": "Contains information about the payment Order. If you want to create an Order with two cards, you can add an item to the array, dividing the total value of the transaction and indicating a different payment method for each one.", - "pt": "Contém informações sobre a Order do pagamento. Caso deseje criar uma Order com dois cartões, você pode adicionar um item ao array, dividindo o valor total da transação e indicando um meio de pagamento diferente em cada item.", - "es": "Contiene información sobre la Order de pago. En caso de querer crear una Order con dos tarjetas, puedes agregar un ítem al array, dividiendo el monto de la transacción y señalando un medio de pago diferente en cada uno. " + "en": "Contains information about the payment Order.", + "pt": "Contém informações sobre a Order do pagamento.", + "es": "Contiene información sobre la Order de pago." }, "items": { "type": "object", @@ -1475,9 +1896,9 @@ { "title": "exceeded_number_of_transactions", "description": { - "en": "An error occurred in the request. The Order accepts a maximum of two transactions. Remove the excess transactions.", - "es": "Ocurrió un error en la solicitud. La Order acepta un máximo de dos transacciones. Elimine las transacciones excedentes.", - "pt": "Ocorreu um erro na requisição. A Order aceita, no máximo, duas transações. Remova as transações excedentes." + "en": "An error occurred in the request. The Order accepts a maximum of one transaction. Remove the excess transactions.", + "es": "Ocurrió un error en la solicitud. La Order acepta un máximo de una transacción. Elimine las transacciones excedentes.", + "pt": "Ocorreu um erro na requisição. A Order aceita, no máximo, uma transação. Remova as transações excedentes." } } ] @@ -2160,9 +2581,9 @@ "type": "array", "required": true, "description": { - "en": "Contains information about the transactions associated with the Order. It can contain up to 2 transactions. For example, if you want to create an Order with two cards, you can add another item to the array \"payments\" node, dividing the total value of the transaction and indicating a different payment method for each one of the items.", - "pt": "Contém informações sobre as transações associadas à Order. Pode conter até 2 transações. Por exemplo, se deseja criar uma Order com dois cartões, você pode adicionar um item ao array \"payments\", dividindo o valor total da transação e indicando uma forma de pagamento diferente em cada um dos itens do array.", - "es": "Contiene información sobre las transacciones asociadas a la Order. Puede contener hasta 2 transacciones. Por ejemplo, en caso de querer crear una Order con dos tarjetas, puedes agregar un ítem al array \"payments\", dividiendo el valor total de la transacción e indicando un método de pago distinto en cada uno de los ítems del array." + "en": "Contains information about the transactions associated with the Order. It can contain only one transaction.", + "pt": "Contém informações sobre as transações associadas à Order. Pode conter apenas uma transação.", + "es": "Contiene información sobre las transacciones asociadas a la Order. Puede contener solo una transacción." }, "items": { "type": "object", @@ -2881,7 +3302,129 @@ "en": "Identifier of the payment method selected to make the payment. If it's a card payment, it will show the brand.", "pt": "Identificador do meio de pagamento selecionado para efetuar o pagamento. Caso seja um pagamento com cartão, indicará a bandeira.", "es": "Identificador del medio de pago seleccionado para realizar el pago. En caso de ser un pago con tarjeta, indicará la bandera." - } + }, + "enum": [ + { + "title": "visa", + "description": { + "en": "Visa credit card.", + "es": "Tarjeta de crédito Visa.", + "pt": "Cartão de crédito Visa." + } + }, + { + "title": "master", + "description": { + "en": "Master credit card.", + "es": "Tarjeta de crédito Master.", + "pt": "Cartão de crédito Master." + } + }, + { + "title": "debelo", + "description": { + "en": "Elo debit card.", + "es": "Tarjeta de débito Elo.", + "pt": "Cartão de débito Elo." + } + }, + { + "title": "debmaster", + "description": { + "en": "Master debit card.", + "es": "Tarjeta de débito Master.", + "pt": "Cartão de débito Master." + } + }, + { + "title": "debvisa", + "description": { + "en": "Visa debit card.", + "es": "Tarjeta de débito Visa.", + "pt": "Cartão de débito Visa." + } + }, + { + "title": "account_money", + "description": { + "en": "Money from the user's Mercado Pago account.", + "es": "Dinero de la cuenta de Mercado Pago del usuario.", + "pt": "Dinheiro da conta do Mercado Pago do usuário." + } + }, + { + "title": "rapipago", + "description": { + "en": "Rapipago payment.", + "es": "Pago en efectivo en Rapipago.", + "pt": "Pagamento em dinheiro no Rapipago." + } + }, + { + "title": "pagofacil", + "description": { + "en": "Pagofacil payment.", + "es": "Pago en efectivo en Pagofacil.", + "pt": "Pagamento em dinheiro no Pagofacil." + } + }, + { + "title": "bolbradesco", + "description": { + "en": "Ticket Bradesco payment.", + "es": "Pago con ticket Bradesco.", + "pt": "Pagamento com ticket Bradesco." + } + }, + { + "title": "oxxo", + "description": { + "en": "Oxxo payment.", + "es": "Pago en efectivo en Oxxo.", + "pt": "Pagamento em dinheiro no Oxxo." + } + }, + { + "title": "paycash", + "description": { + "en": "Paycash payment.", + "es": "Pago en efectivo en Paycash.", + "pt": "Pagamento em dinheiro no Paycash." + } + }, + { + "title": "bancomer", + "description": { + "en": "Bancomer payment.", + "es": "Pago en efectivo en Bancomer.", + "pt": "Pagamento em dinheiro no Bancomer." + } + }, + { + "title": "banamex", + "description": { + "en": "Banamex payment.", + "es": "Pago en efectivo en Banamex.", + "pt": "Pagamento em dinheiro no Banamex." + } + }, + { + "title": "clabe", + "description": { + "en": "Clabe payment.", + "es": "Pago con Clabe.", + "pt": "Pagamento com Clabe." + } + }, + { + "title": "pix", + "description": { + "en": "Pix payment.", + "es": "Pago con Pix.", + "pt": "Pagamento com Pix." + } + } + ] }, "type": { "type": "string", @@ -2890,7 +3433,57 @@ "en": "Type of payment method selected to make the payment.", "pt": "Tipo de meio de pagamento selecionado para efetuar o pagamento.", "es": "Tipo de medio de pago seleccionado para realizar el pago." - } + }, + "enum": [ + { + "title": "credit_card", + "description": { + "en": "Credit card.", + "es": "Tarjeta de crédito.", + "pt": "Cartão de crédito." + } + }, + { + "title": "debit_card", + "description": { + "en": "Debit card.", + "es": "Tarjeta de débito.", + "pt": "Cartão de débito." + } + }, + { + "title": "account_money", + "description": { + "en": "Money from the user's Mercado Pago account.", + "es": "Dinero de la cuenta de Mercado Pago del usuario.", + "pt": "Dinheiro da conta do Mercado Pago do usuário." + } + }, + { + "title": "ticket", + "description": { + "en": "Cash payment.", + "es": "Pago en efectivo.", + "pt": "Pagamento em dinheiro." + } + }, + { + "title": "atm", + "description": { + "en": "ATM payment.", + "es": "Pago en cajero automático.", + "pt": "Pagamento em caixa eletrônico." + } + }, + { + "title": "bank_transfer", + "description": { + "en": "Bank transfer.", + "es": "Transferencia bancaria.", + "pt": "Transferência bancária." + } + } + ] }, "token": { "type": "string", @@ -3049,6 +3642,33 @@ "pt": "Número da rua do endereço do pagador.", "es": "Número de la calle de la dirección del pagador." } + }, + "neighborhood": { + "type": "string", + "example": "Pres. Altino", + "description": { + "en": "Payer's address neighborhood. Required for \"payment_method.id\" bolbradesco", + "pt": "Bairro do endereço do pagador. Obrigatório para \"payment_method.id\" bolbradesco", + "es": "Barrio de la dirección del pagador. Requerido para \"payment_method.id\" bolbradesco" + } + }, + "federal_unit": { + "type": "string", + "example":"SP", + "description": { + "en": "Payer's address federal unit. Required for \"payment_method.id\" bolbradesco", + "pt": "Unidade federativa do endereço do pagador. Obrigatório para \"payment_method.id\" bolbradesco", + "es": "Unidad federativa de la dirección del pagador. Requerido para \"payment_method.id\" bolbradesco" + } + }, + "city": { + "type": "string", + "example":"Osasco", + "description": { + "en": "Payer's address city. Required for \"payment_method.id\" bolbradesco", + "pt": "Cidade do endereço do pagador. Obrigatório para \"payment_method.id\" bolbradesco", + "es": "Ciudad de la dirección del pagador. Requerido para \"payment_method.id\" bolbradesco" + } } } } @@ -4421,7 +5041,7 @@ }, "responses": { "unauthorized": { - "description": { + "description": { "en": "Error. Access Token not authorized.", "pt": "Erro. Access Token não autorizado.", "es": "Error. Access Token no autorizado."