Configurações básicas:

Hoje nosso produto está preparado para integrações de parceiros que queiram utilizar em um software de gestão de PDV, quanto para soluções de autosserviço.

Dessa forma temos um parâmetro que tem que ser configurado antes do produto ser ativado para o AutoTEF identificar qual é a sua integração. Basta seguir os seguintes passo:

• Abra seu pacote e em seguida abra as configurações que se encontram em "app.setting";
• Se a sua aplicação é usada em um software de gestão de PDV altere o parâmetro "IsPDV" para "true";
• Caso seja para soluções autosserviço o parametro "IsPDV" para "false".

📘

Por que realizar essa configuração?

Quando o AutoTEF é utilizado diretamente em software de PDV, temos a possibilidade de realizar o cancelamento via operador de caixa, porém a rota só irá funcionar com a configuração correta do pacote.

Lembrando também que esses dados são utilizados para mensurarmos onde o produto está sendo mais utilizado.

📘

Informação para configuração de Ambiente:

No final da homologação, você receberá o nosso OK para ir para produção. Neste momento o Gerente Comercial Stone responsável por sua parceria conosco irá disponibilizar a configuração necessária para ambiente de produção.

Configurações para Ativação:

O momento da Ativação serve para fazer a comunicação com o endpoint para verificarmos a comunicação com ambiente do autorizador Stone e da carga de tabela Stone, junto com o stone code criado pelo seu gerente comercial.

Essa rota deve ser chamada uma vez no start da aplicação, ela identifica o parceiro e cria um objeto autorizador para realização das transações subsequentes.
Seguindo o exemplo de valor na fase 2 da homologação, apontando os teste para sandbox;

Request: Endpoint: /api/Activate

{
  "StoneCode":  "9999999", // String,
  "ConnectionName":"COM11", //String,
  "PartnerName": "" // String
}

🚧

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.

Envio do campo “partner.name” via activate

Este método permite identificar o Parceiro no campo SysName, esse campo vem através da nossa mensageria, esta informação é mandatória Stone.

Exemplos:
partnerName: “VendPago*3.1.1”
partnerName: “PowerVending*2.4.3”
partnerName: “Lavanderia60min*1.8.5”
partnerName: “GasFacil*1.0”

Definições:

• StoneCode // Número de afiliação.

• partnerName // nome do parceiro.

Response:

👍

Status 200 - OK

{
    "StoneCode": “String”, // String,
    "Started": "YYYY-MM-DDTHH:mm:SS", // String,
    "PartnerName": "", //String, 
    "ConnectionName": "COM11", //String
  }

❗️

Status 400 - Não foi possível conectar, tente novamente.

{
  "Message": "Não foi possível conectar, tente novamente.",
  "StatusCode": 400
}

❗️

Status 400 - Quando o Stone Code não tiver na carga correta ou no ambiente errado irá dar o seguinte retorno:

{
  "Message": "Check if the environments are correct for the used stone code. If the problem persists, contact us.",
  "StatusCode": 400
}

❗️

Status 500 - "Fist call the activate router or check connections in endpoint 'api/Healthcheck'"

{
  "message": "First call the activate router or check connections in endpoint 'api/Healthcheck'.",
   "statusCode": 500
}

📘

Observação

a propriedade “started” é a data e hora de quando o endpoint /activate foi utilizado ativo. Caso precise alterar algum desses valores o slim deve ser reiniciado para obter um novo objeto Autorizador.