Posso ligar a Airwallet ao meu próprio sistema de relatórios?
Posso ligar a Airwallet ao meu próprio sistema de relatórios?
Acesso à API
Sim. A Airwallet tem uma interface que permite aos seus próprios sistemas ler os seus dados da Airwallet. Pode carregar transações, o estado das máquinas e dados dos locais no seu sistema de relatórios, no seu data warehouse ou na sua ferramenta de business intelligence.
Está disponível no plano Smart e no plano Business. Não está disponível no plano Basic. Não há taxa adicional além do plano.
Que dados pode obter
Dados | O que contêm |
|---|---|
Transações | Valor, moeda, local, dispositivo, tipo de máquina, tipo de pagamento, plataforma, saldo da carteira e hora |
Reembolsos | Os mesmos campos, mais uma ligação para a transação original e o motivo |
Carregamentos da carteira | Valor, moeda, identificador do utilizador e hora |
Disponibilidade das máquinas | Estado em tempo real por máquina (disponível, em utilização, em manutenção), tipo de máquina e último pagamento |
Detalhes do dispositivo | Marca, modelo, número de série, preço, programas da máquina, contadores de serviço e última utilização |
Locais | Morada, coordenadas, horário de funcionamento, definições de reserva, moeda e lista de máquinas |
Terminais | Número de série, idioma predefinido e estado |
Cupões | Campanhas de desconto, com o âmbito, o tipo e os resgates |
Clientes | As contas empresariais abaixo da sua, se gerir locais para outras empresas |
Os locais, dispositivos, terminais e cupões também aceitam pedidos de criação, atualização e eliminação. As transações, os reembolsos e os carregamentos da carteira são apenas de leitura.
Com que frequência pode atualizar
É o cliente que decide o calendário. Uma atualização por dia é normal. Uma atualização por hora também.
Um pedido devolve até 10.000 registos. Para volumes maiores, percorre os resultados página a página.
A Airwallet retém os últimos dez minutos de transações. Os pagamentos muito recentes ainda podem estar a ser processados. Não trate os dados dos últimos dez minutos como definitivos.
O que a interface não faz atualmente
Não devolve registos de utilizadores finais. As transações incluem um identificador de utilizador. Pode agrupar a atividade por utilizador e acompanhar um utilizador ao longo do tempo. Não pode descobrir quem é a pessoa por trás desse identificador.
Não lhe envia dados. O seu sistema pede os dados à Airwallet. A Airwallet não contacta o seu sistema quando algo acontece. Para uma atualização diária, isso não faz diferença.
Como obter acesso
- Tenha uma conta no Dashboard com o plano Smart ou o plano Business. Consulte Planos.
- Envie o endereço de e-mail da conta ao seu contacto na Airwallet. Peça acesso de programador.
- A Airwallet ativa o acesso de programador. Aparece então uma secção Developer no Dashboard, em Settings.
- Gere o seu par de chaves nessa secção. Guarde a chave secreta imediatamente. A Airwallet mostra a chave secreta apenas uma vez.
Onde está a documentação técnica
A especificação completa está no Dashboard, em Settings e depois Developer. Abrange todos os endpoints, todos os parâmetros e todas as respostas. Fica acessível depois de a Airwallet ativar o acesso de programador.
Há também um ambiente de teste, para que o seu programador possa desenvolver e testar antes de entrar em produção.
Contacte o seu representante da Airwallet para obter acesso, ou se precisar de algo que a interface ainda não faz. Descreva o que pretende criar e o volume de dados que prevê.
Actualizado em: 12/11/2026
Obrigado!