MobiTEF Server¶
Essa documentação tem como referência a versão corrente como minima do MobiTEF Server.
O MobiTEF Server desempenha o papel crucial de integrar a automação comercial e os terminais de pagamento, atuando como intermediário na comunicação entre eles. Sua função é passiva nessa integração, significando que a automação e o aplicativo iniciam a comunicação diretamente com o servidor. As funcionalidades do MobiTEF Server, acessadas pela automação e pelo App MobiTEF, são disponibilizadas por meio de uma API Gateway. Esta API realiza a autenticação, com suporte do AWS Cognito, e a autorização das automações e terminais para acessarem seus respectivos recursos.
Funcionalidades¶
A seguir, serão apresentadas as principais funcionalidades disponíveis na automação do MobiTEF Server.
Pagamentos¶
O processo de início de pagamento é conduzido pela automação comercial, com uma variedade de estados possíveis para o pagamento. Esses estados estão delineados na tabela a seguir:
| Status | Descrição |
|---|---|
| PAYMENT_REQUEST | Estado inicial de um pagamento. |
| UNDO_REQUEST | A automação requisitou o desfazimento do pagamento. |
| CONFIRM_REQUEST | A automação requisitou a confirmação do pagamento. |
| WAITING_CONFIRMATION | O pagamento está a espera da automação confirmá-lo. Isto pode acontecer devido a necessidade de impressão de documento fiscal para o pagamento. |
| CONFIRMED | O pagamento está confirmado. |
| UNDONE | O pagamento está desfeito. |
| DECLINED | O pagamento foi negado. |
| ERROR | Aconteceu erro durante o processamento do pagamento. |
Estornos¶
| Status | Descrição |
|---|---|
| REVERSAL_REQUEST | Estado inicial de um pagamento. |
| UNDO_REVERSAL_REQUEST | A automação requisitou o desfazimento do pagamento. |
| REVERSED | A automação requisitou a confirmação do pagamento. |
| REVERSAL_UNDONE | O pagamento está sendo processado. |
| REVERSAL_DECLINED | O desfazimento do pagamento está sendo processado. |
Credenciais¶
Para consumir os recursos do MobiTEF-server, se faz necessário realizar o cadastro no portal da paystore do usuário e senha do lojista. Para isso, o facilitador precisa está previamente cadastrado e ter acesso ao portal da paystore.
O usuário e senha são gerados pelo portal automaticamente, bastando selecionar o lojista desejado. Essas credenciais devem ser usadas para geração do token a partir do recursos /authentication/authUser
De posse do token, já é possível consumir os demais recursos dessa documentação.