Integrar o modelo autônomo do QR

Para integrar o modelo desatendido, é necessário:

  1. Criar o serviço que será invocado ao receber uma intenção de pagamento e sua lógica associada.

    • A. As informações do pedido ainda não foram disponibilizadas.
    • B. As informações do pedido são disponibilizadas.
  2. Declarar o URL de seu domínio a Mercado Pago.

1. Criar o serviço que será invocado para receber uma intenção de pagamento

Tem que criar um serviço que será invocado por Mercado Pago cada vez que quiser realizar um pagamento com um código QR.

Este serviço deve restituir as informações do pedido a cobrar. Por exemplo: https://www.miempresa.com/pay-mp?storeid=6232&posid=1

O URL do serviço é declarado no campo URL do caixa (QR).

Lógica do serviço

Implementa a seguinte lógica no serviço para suportar os casos a seguir:

A. As informações do pedido ainda não foram disponibilizadas

Pode acontecer que as informações do pedido ainda não foram disponibilizadas ao querer realizar o pagamento. Por exemplo, durante o abastecimento de combustível.

Nesses casos, o serviço deve responder uma mensagem de erro para que o usuário possa ver uma tela de espera. O serviço deve retornar um código de estado HTTP 400 (Bad Request) e a resposta deve continuar o formato a seguir:

Json

{
"error": 
{  "type": "XXX",
  "message": "YYYY" }
}

Atributos

Tipo (type) Descrição
in_process Tem um pedido em processo, porém, ainda não foi possível determinar o valor a receber.
unavailable Não tem pedido em processo ou pendente de pagamento.
invalid Os parâmetros adicionais (ID de estação, posição, etc.) fazem referência a uma localização desconhecida.
timeout O server do vendedor não conseguiu se comunicar com algum dos sistemas internos (por exemplo, a máquina de venda automática) e cancelou a operação.

O message é opcional, é uma explicação em texto plano que pode acompanhar o type declarado.

B. As informações da ordem foram disponibilizadas

Se já existir uma ordem para receber, o serviço deve restituir suas informações.

A resposta esperada deste serviço deve conter o header Content-Type: application/json e o estado HTTP 200 (OK).

A resposta deve conter a mensagem seguinte sobre o pedido a ser recebido:

Json

{
   "collector_id": 178106235,
   "sponsor_id": 334249281,
   "items":[
      {
         "title":" $500.00 de SUPER",
         "currency_id": MXN,
         "description":"$500.00 de SUPER",
         "quantity": 1.0,
         "unit_price": 500.00
      }
   ],
   "external_reference":"45ea80da",
   "notification_url":"https://www.tusitio.com"
}

Deve utilizar o campo external_reference para poder identificar o pedido em seu sistema dentro de Mercado Pago.

Atributos

Atributo Tipo (type) Descripción
collector_id Long Identificador da conta Mercado Pago onde os pagos serão creditados.
sponsor_id Long Identificador da conta Mercado Pago do sistema integrador.
items.title String Título do produto.
items.currency_id String(3) Identificador de moeda no formato ISO-4217.
items.description String Descrição do produto.
items.quantity Integer Quantidade do produto envolvido.
items.unit_price Decimal Preço unitário do produto.
external_reference String (256) Referência para poder associar a ordem em Mercado Pago com ordem de compra, comanda ou despacho em seu sistema. Geralmente, é utilizado o número de NF.
notification_url String URL aonde as notificações serão enviadas.

2. Declarar o URL de seu domínio a Mercado Pago

Deve informar ao seu assessor técnico atribuído, o URL base de seu domínio ao qual Mercado Pago consultará por cada transação.

ATENÇÃO

A integração não dará certo se você não cumprir este passo.


Próximos passos

Integração avançadaREQUERIDO

Conheça as opções disponíveis para chegar à integração para o seguinte nível.

Teste sua integraçãoRECOMENDADO

Realiza os casos de uso mais frequentes para validar sua integração.








La búsqueda no arrojó ningún resultado.

Verifica la la ortografía de los términos de búsqueda o prueba con otras palabras clave.