O ASAAS é uma Gateway de pagamento, a integração funciona por meio de um webhook, que é uma função de callback usada para enviar informações automaticamente entre sistemas através de um endereço HTTP.
Como Funciona:
- Quando você ativa um webhook, ele passa a enviar requisições HTTP POST para o endereço configurado sempre que o evento específico acontecer.
- A requisição inclui informações detalhadas sobre o evento e o recurso envolvido, permitindo a integração e a comunicação entre diferentes sistemas.
Se você utiliza o sistema ASAAS para gerenciar os seus clientes, siga os passos abaixo para iniciar a integração API com a Alloyal:
Etapa 1:
É necessário solicitar a “chave API” do ASAAS e listar “eventos de ativação/desativação” do usúario.
Ao clicar em “Gerar nova chave API, será gerado o token. Esse é um dos dados que o cliente deve nos enviar. É preciso que seja informado também os eventos que serão associados para ativação/desativação do usúario.
Segue abaixo a documentação da ASAAS com as informações dos eventos:
É possível utilizar como parâmetro (caso não tenha certeza do que ira precisar usar) os eventos abaixo:
- Eventos de criação e ativação de usuário:
PAYMENT_AUTHORIZED
PAYMEN_CONFIRMED
PAYMENT_CREATED
PAYMENT_APPROVED_BY_RISK_ANALYSIS
PAYMENT_RECEIVED
PAYMENT_ANTICIPATED
- Eventos de desativação:
PAYMENT_REPROVED_BY_RISK_ANALYSIS
PAYMENT_CREDIT_CARD_CAPTURE_REFUSED
PAYMENT_DELETED
PAYMENT_REFUNDED
PAYMENT_CHARGEBACK_DISPUTE
PAYMENT_CHARGEBACK_REQUESTED
PAYMENT_OVERDUE
Etapa 2:
Com a chave API (token) em mãos, o cliente deve encaminhá-la ao responsável pela Implantação na Alloyal. Esse envio pode ser feito através do telefone +55 31 99192-9641 ou pelo e-mail suporte@alloyal.com.br. É essencial que o token seja enviado corretamente para dar continuidade ao processo de integração e desenvolvimento das funcionalidades.
Etapa 3:
Após enviar o token para o time da Alloyal, o usuário logado em sua conta no ASAAS deve criar um webhook.
Configurações necessárias:
- Acesse as configurações do sistema ASAAS para criar o webhook:
- Configure o endereço HTTP, selecionando os eventos de ativação e desativação definidos anteriormente:
- Agora configure todos os eventos dentro do webhook:
Finalização:
Após selecionar e configurar todos os eventos dentro do webhook:
- Salve as alterações.
- Confirme que o webhook foi criado e configurado corretamente.
O processo estará concluído, e o webhook estará pronto para integrar as plataformas.