Configurar beacons

Nossos terminais Bluetooth usam o protocolo iBeacon para anunciar sua presença em outros dispositivos Bluetooth próximos, como uma caixa registradora móvel. Você pode usar os dados anunciados para garantir que os pagamentos iniciados na caixa registradora sejam sempre roteados para o terminal mais próximo.

O terminal indica os seguintes valores, especificados de acordo com o protocolo iBeacon:

• UUID: Um identificador universalmente único que consiste em 32 dígitos hexadecimais.
• Major: Um valor decimal entre 0 e 65535.
• Minor: Um valor decimal entre 0 e 65535.

Você pode configurar esses valores quando configurar beacons na sua área de cliente. Depois de configurado, você pode usar os valores Major e Minor anunciados para encaminhar solicitações de pagamento ao terminal de publicidade. As informações exatas necessárias para rotear uma solicitação de pagamento para um terminal específico dependem da sua integração com a API de terminais:

• Comunicação baseada em nuvem
• Comunicação local

Comunicação baseada em nuvem

Com a comunicação baseada na nuvem, uma solicitação de pagamento é roteada para o terminal correto com base no ID do terminal exclusivo, o POIID, no qual você passa na solicitação de pagamento.

Você pode usar nossos placeholders para que o terminal anuncie seu número de série, codificado em Major ou Minor. Então, para obter o  POIID:

1. Obtenha o número de série do Major e do Minor. 
2. Obtenha o modelo do terminal. Para recuperar uma lista dos POIIDs de todos os terminais conectados, use nossa connectedTerminals API.

Comunicação local

Com a comunicação local, uma solicitação de pagamento é roteada para o terminal correto com base em:

• O ID exclusivo do terminal, o POIID, que você envia na mensagem de solicitação.  
• O endereço IP do terminal. Use isso para determinar o endpoint para a solicitação.

Você pode usar nossos placeholders para que o terminal anuncie seu endereço IP, codificado em Major e Minor. Para encaminhar solicitações para o terminal correto, você precisa:

1. Obter o endereço IP do Major e do Minor .
2. Obter o POIID. Para isso, você deve usar seu próprio mapeamento do endereço IP para o POIID. Para preencher esse mapeamento dinamicamente:
   1. Envie um DiagnosisRequest com um modelo POIID (por exemplo, V400m-123456789).
   2. Extraia o POIID atual do terminal da resposta e atualize seu mapeamento.
3. Enviar suas PaymentRequest (e outras solicitações) usando o POIID correto para o IP selecionado na etapa 1.

Para obter ajuda e sugestões adicionais, entre em contato com  Support Team.

Configure beacons na sua área de cliente

Para ativar a funcionalidade do iBeacon e definir seus valores para UUID, Major, e Minor:

1. Faça login na sua Customer Area. 

2. Vá para Point-of-Sale > Terminals. 
   Isso abre uma página com uma lista de todos os terminais em sua company account.

   Você também pode configurar a funcionalidade do iBeacon no nível merchant account, store account, ou para um único terminal. Para isso, vá até o nível necessário antes de prosseguir para a próxima etapa.

3. Vá para a guia Network.

4. Na seção Beacon, defina:

   1. Enable beacons > Yes. 
   2. UUID para o identificador universal universal que você deseja usar. Você pode gerar um UUID usando uma ferramenta online, por exemplo, uuidgenerator.
   3. Major e Minor para os valores que você deseja usar. Você pode escolher seus próprios valores ou usar nossos placeholders. 

5. Clique em Save na parte inferior da página.

Placeholders para os Major e Minor 

Você pode usar os placeholders para codificar dinamicamente nos Major e Minor:

• O número de série do terminal - se você estiver usando comunicação baseada em nuvem com a API do Terminal. Para isso, defina:
  Major	${SERIALH}
  Minor	${SERIALL}

  Para saber como decodificar os dados anunciados, consulte Obter o número de série.

• O endereço de IP do terminal - se você estiver usando comunicação local com a API de terminais. Aqui, o espaço reservado também depende da sua interface de rede. Por exemplo, se você estiver usando a primeira interface Ethernet, defina Major para ${IPH:ETH0}, e Minor para ${IPL:ETH0}.

  Major	${IPH:ETH0}	${IPH:ETH1}	${IPH:WLAN0}	${IPH:WLAN1}	${IPH:GPRS0}
  Minor	${IPL:ETH0}	${IPL:ETH1}	${IPL:WLAN0}	${IPL:WLAN1}	${IPL:GPRS0}

Para aprender a decodificar os dados anunciados, consulte Obter o endereço IP.

Obter o número de série

Se você definir Major para ${SERIALH} e Minor para ${SERIALL},o terminal anunciará seu número de série, codificado em Major e Minor. Por exemplo, o número de série 324688179 é anunciado como:

• Major: 4954
• Minor: 22835

Para obter o número de série dos valores anunciados:

1. Converta o Major e o Minor em hexadecimal:   
   • hex (4954) = 135A
   • hex (22835) = 5933
2. Concatene os valores, com o Major correspondendo aos bits mais altos e o Minor correspondendo aos bits mais baixos:
   • 135A5933
3. Converta o valor resultante em decimal:  
   • dec(135A5933) = 324688179

Obter o endereço IP

Você pode usar nossos espaços reservados para que o terminal anuncie seu endereço IP, codificado em Major e Minor.

Por exemplo, o endereço IP 192.168.47.95 é anunciado como:

• Major: 49320
• Minor: 12127

Para obter o endereço IP dos valores anunciados:

1. Obtenha os 16 bits mais altos do endereço IP do Major:

   1. Converta o Major em hexadecimal:
      • hex (49320) = C0A8
   2. Converta os bits altos do resultado em decimal:
      • dec(C0) = 192
   3. Converta os bits baixos do resultado em decimal:
      • dec (A8) = 168
   4. Combine os resultados das etapas b. e c. para obter os 16 bits mais altos do endereço IP:
      • 192.168

2. Obtenha os 16 bits baixos do endereço IP do Minor: 

   1. Converta o Minor em hexadecimal:
      • hex (12127) = 2F5F
   2. Converta os bits altos do resultado em decimal:
      • dec(2F) = 47
   3. Converta os bits baixos do resultado em decimal:
      • dec (5F) = 95
   4. Combine the results of steps b. and c. to get the low 16 bits of the IP address: 
      • 47.95

3. Combine os resultados das etapas 1. e 2. para obter os 16 bits mais altos do endereço IP:  

   • 192.168.47.95

Veja também