Como integrar Mercado Pago Point

Para poder cobrar de maneira integrada com nosso dispositivo Point é necessário baixar a aplicação do Mercado Pago disponível nos marketplaces de iOS e Android.

Existem dois cenários na hora de integrar Point:

1. Quando a aplicação pode ser utilizada no mesmo dispositivo (celular ou tablet) onde está instalada a aplicação de Mercado Pago. É possível logar com uma integração de deep linking ou intent-based.

2. Quando a aplicação não pode ser utilizado no mesmo dispositivo (celular ou tablet) onde está instalada a aplicação do Mercado Pago. É possível logar com uma integração via API.

A outra forma de integração com o aplicativo Mercado Pago para cobrar com nosso Point é através de nossas APIs.

Para fazer a integração, é necessário habilitar as opções de integração no aplicativo Mercado Pago. Execute o seguinte curl para fazer isso:

--location --request POST ‘https://api.mercadopago.com/point/services/user/status/integrators?access_token= <ENV_ACCESTOKEN>’ \
--header ‘Content-Type: application / json’ \
--data-raw ‘{
    "Id": <user_id>
} ’

Em seguida, é necessário configurar o device_name do aplicativo Mercado Pago. Serve para identificar seu celular ou tablet e relacioná-lo com sua conta do Mercado Pago. Desta forma, você saberá para qual dispositivo enviar a ordem de pagamento.

O passo seguinte, consiste em gerar uma ordem de pagamento e envia-la via API ao dispositivo de onde se deseja cobra-la. O usuário verá que na tela desse dispositivo se abre a aplicação de Mercado Pago pronta para passar o cartão e avançar com o fluxo de pagamento utilizando a Point.

Uma vez que o pagamento é processado, o usuário verá o resultado do pagamento na aplicação do Mercado Pago. Finalmente, a ordem gerada se fechará e se criará o pagamento correspondente.

O POST nessa API gera uma ordem, que é a que recebe a aplicação de Mercado Pago para cobrar com a Point, com um identificador que se pode utilizar para saber o status da mesma.

curl -X POST \
-H "Content-Type: application/json" \
-H 'Authorization: Bearer ACCESS_TOKEN' \
-d '{"amount":100,"description":"xícara","device_name":"dispositivo","cc_type":"credit_card"}' \
'https://api.mercadopago.com/point/services/integrations/v1'

Os parâmetros que se podem incluir são:

• amount: O valor que será cobrado do cliente (*).
• description: Uma descrição da operação (Máx.: 20 caracteres) (*).
• device_name: É o nome do dispositivo que receberá a ordem de pagamento (*).
• cc_type: O tipo de cartão. Pode ser credit_card (*).
• external_reference: O código de referência do seu sistema, o mesmo permitirá conciliar o pedido de compra com o pagamento.
• disable_back_button: True ou False. Para que ao clicar no botão de voltar a ordem de pagamento se feche ou não.
• notification_url: É a URL que irá receber a notificação desse pagamento.
• payer_email: É o email do pagador.

A resposta terá o seguinte formato:

{
  "status":"OPEN",
  "id":<order_id>
}

Response status code: 200 OK

O GET nesta API, junto ao order_id, possibilita recuperar o estado da mesma para saber se foi gerado o pagamento ou não.

curl -X GET \
-H "Content-Type: application/json" \
-H 'Authorization: Bearer ACCESS_TOKEN' \
'https://api.mercadopago.com/point/services/integrations/v1/:ID'

Se o status da ordem é OPEN quer dizer que a mesma ainda não foi paga. Se o status é CLOSED quer dizer que a ordem já foi paga e, portanto, obterá o payment_id com o resto da informação. A resposta terá o seguinte formato.

{
  "status":"CLOSED",
  "id":<order_id>,
  "payment_id":<payment_id>,
  "payment_status":"<payment_status>",
  "external_reference": "<external_reference>",
  "payer_email": "<email_payer>"
}

Response status code: 200 OK

O DELETE nesta API possibilita eliminar uma ordem. Existem duas formas de eliminar a ordem.

É possível eliminar a ordem por device_name:

curl -X DELETE \
-H "Content-Type: application/json" \
-H 'Authorization: Bearer ACCESS_TOKEN' \
'https://api.mercadopago.com/point/services/integrations/v1/attempt/device/:DEVICE_NAME'

A resposta terá o seguinte formato.

{
  "status":"OK"
}

Response status code: 200 OK

Ou é possível eliminar a ordem por order_id:

curl -X DELETE \
-H "Content-Type: application/json" \
-H 'Authorization: Bearer ACCESS_TOKEN' \
'https://api.mercadopago.com/point/services/integrations/v1/:ID'

Response status code: 204 OK

O GET nesta API possibilita obter todos os dispositivos configurados e sincronizados para sua conta do Mercado Pago

curl -X GET \
-H "Content-Type: application/json" \
-H 'Authorization: Bearer ACCESS_TOKEN' \
'https://api.mercadopago.com/point/services/integrations/v1/devices'

Se o status do dispositivo é FREE quer dizer que o dispositivo pode receber uma ordem nova. Se o status é BUSY quer dizer que o dispositivo já tem uma ordem associada. A resposta terá o seguinte formato.

{
  "devices"[{
    "name": "<device_name>",
    "caller": <id_interno>,
    "id": <id_interno>,
    ”status”:{
      status”:”FREE”,
      "payment_attempt": <order_id>
    }
  }]
}

Response status code: 200 OK

O DELETE nesta API possibilita apagar algum dos dispositivos configurados e sincronizados para sua conta de Mercado Pago.

curl -X DELETE \
-H "Content-Type: application/json" \
-H 'Authorization: Bearer ACCESS_TOKEN' \
'https://api.mercadopago.com/point/services/integrations/v1/devices/:DEVICE_NAME'

A resposta terá o seguinte formato.

{
  "status":"OK"
}

Response status code: 200 OK

É necessário que envie sua notification_url, onde receberá aviso de todos os novos pagamentos e atualizações de status que se gerem.

No artigo de notificações é possível obter mais informações.

Os pagamentos de Point podem ser buscados na API de Payments. Pode-se encontrar mais informações no artigo de API's

Existe uma API exclusiva de Point que conta com informações adicionais do pagamento:

curl -X GET \
-H "Content-Type: application/json" \
-H 'Authorization: Bearer <access_token>' \
https://api.mercadopago.com/point/services/payment/<payment_id>

A resposta terá o seguinte formato:

{
  "payment_id": 12345,
  "caller_id": 44444,
  "poi": "BBPOS-123123123",
  "poi_type": "BBPOS",
  "operator_id": 555555,
  "buyer_info": {
    "email": "email@email.com"
  }
}