Portuno
Fluxo de autorização
Figura 1. Fluxo de autorização
1. Entrada de Dados no Terminal
2. Envio de Dados para o PDV/TEF
O PDV/TEF monta uma transação com os dados do portador e envia para a Processadora de Pagamentos.
3. Validação do Token no Portuno
4. Encaminhamento para Autorização
5. Resultado da Transação
Fluxo entre o APP e o Portuno
Figura 2. Fluxo do APP com Portuno
1. APP faz autenticação no Horizon
2. Consulta Cartões do Portador
3. Verificação do Secret no Portuno
Se o secret existir:
Se o secret não existir:
Jornada de Autenticação
1.
2.
3.
4.
5.
6.
Endpoints
Integração
| Tipo | Endpoint | Descrição |
|---|---|---|
| GET | /api/v1/portuno/integrations | Lista as integrações cadastradas |
Conta
| Tipo | Endpoint | Descrição |
|---|---|---|
| POST | /api/v1/portuno/accounts | Cadastra uma conta |
| PUT | /api/v1/portuno/accounts | Troca o secret de uma conta |
| GET | /api/v1/portuno/accounts | Lista as contas |
Casos de uso
Criar uma conta
{
"integration": "Teste",
"externalId": "velho",
"issuer": "Sandbox"
}'
{
id": 12,
"externalId": "velho",
"secret": "X5OWXEE3TNCKV4WA",
"qrUri": "otpauth://totp/Teste%3Avelho?secret=X5OWXEE3TNCKV4WA&issuer=Teste&algorithm=SHA1&digits=6&period=30",
"status": "ACTIVE",
"createdAt": "2025-01-21"
}
Listar contas
externalId: "TESTE", issuer: "Sandbox" productId: "1" para listar as contas.[
{
"id": 2,
"externalId": "TESTE",
"secret": "S2KHY4LMMLVJFWK5",
"qrUri": "otpauth://totp/Teste%3ATESTE?secret=S2KHY4LMMLVJFWK5&issuer=Teste&algorithm=SHA1&digits=6&period=30",
"status": "ACTIVE",
"createdAt": "2024-08-14"
}
]Trocar o segredo da conta
{
"integration": "Teste",
"externalId": "Novo",
"issuer": "Sandbox"
}{
"id": 2,
"externalId": "TESTE",
"secret": "TU2QF4BCBQBGFNV5",
"qrUri": "otpauth://totp/Teste%3ATESTE?secret=TU2QF4BCBQBGFNV5&issuer=Teste&algorithm=SHA1&digits=6&period=30",
"status": "ACTIVE",
"createdAt": "2025-01-21"
}Listar integrações
nomeEmissor: "Sandbox" para listar todas as integrações com esse emissor.[
{
"id": 2,
"description": "Teste",
"integration": "Teste",
"issuer": "Sandbox",
"active": true,
"productId": 1,
"token": {
"digits": 6,
"period": 30
}
},
{
"id": 3,
"description": "Descricao",
"integration": "Integracao",
"issuer": "Sandbox",
"active": true,
"productId": 2,
"token": {
"digits": 6,
"period": 30
}
},
{
"id": 4,
"description": "NewDescricao",
"integration": "NewIntegracao",
"issuer": "Sandbox",
"active": true,
"productId": 2,
"token": {
"digits": 6,
"period": 30
}
},
{
"id": 5,
"description": "NewDescricao",
"integration": "NovoIntegracao",
"issuer": "Sandbox",
"active": true,
"productId": 2,
"token": {
"digits": 6,
"period": 30
}
},
{
"id": 6,
"description": "NewDescricao",
"integration": "Novo",
"issuer": "Sandbox",
"active": true,
"productId": 2,
"token": {
"digits": 6,
"period": 30
}
},
{
"id": 1,
"description": "Integration Sandbox",
"integration": "Integration Sandbox",
"issuer": "Sandbox",
"active": true,
"productId": 1,
"token": {
"digits": 6,
"period": 30
}
},
{
"id": 7,
"description": "n",
"integration": "I",
"issuer": "Sandbox",
"active": true,
"productId": 2,
"token": {
"digits": 6,
"period": 20
}
},
{
"id": 8,
"description": "NewDescricao",
"integration": "teste",
"issuer": "Sandbox",
"active": true,
"productId": 2,
"token": {
"digits": 6,
"period": 30
}
}
]Os endpoints irão retornar os dados que podem ser acessados de acordo com suas credenciais de autenticação. Para mais informações, visite a página de autenticação.