Ativação

Endpoint de Ativação do Stone Code e Inicialização do Pinpad.

Endpoint

POST http://localhost:8000/api/Activate

Corpo da requisição

Campo	Tipo	Obrigatório	Descrição
stoneCode	string	sim	Código de credenciamento da Stone
connectionName	string	não	Nome da porta periférica (ex.: COM4 ou /dev/ttyACM0)
partnerName	string	sim	Nome da aplicação integradora (Ex.: MACHINEVEND 1.0)
urlNotification	string	não	Url para receber notificações Webhook da aplicação

Exemplo

{
  "stoneCode": "123123123",
  "connectionName": "COM4",
  "partnerName": "MACHINEVEND 1.0"
}

Essa rota deve ser chamada uma única vez durante a inicialização da aplicação. Seu objetivo é identificar o parceiro e criar um objeto autorizador, que será utilizado para realizar as transações subsequentes.

Esse endpoint é responsável por estabelecer comunicação com o pinpad, verificar a integração com o credenciamento Stone, realizar a carga da tabela e inicializar as comunicações com o pinpad.

A propriedade "connectionName"

No Linux, é importante informar o endereço da porta do pinpad (ex:/dev/ttyS5), caso não seja informado, a aplicação fará uma varredura de portas. O que poderá ocorrer problemas a outros periféricos ligados. Para liberar acesso a porta, utilize o comando $ sudo chmod a+rw /dev/ttyACM0 como descrito aqui

Obs: ttyACM0 é o padrão, parceiro tem que confirmar e identificar qual a porta se encontra o pinpad.

Para nova ativação

a propriedade started é a data e hora de quando o endpoint /api/activate foi utilizado e a aplicação ativada. Caso precise mudar o Stone Code ou perda de conexão com o pinpad, reinicie a aplicação e ative novamente.

Jornada: Começar a integrar
Etapa 9 de 10

Etapa anteriorRaspberry Pi + Slim Próxima etapaHealthcheck