QITech
Integração para desembolso e validação de chave PIX com a QITech.
Desembolso
Quando uma proposta é aprovada, um dívida será criada na QITech e o status do empéstimo será alterado para “Desembolsando” (disbursing
). Ao receber uma confirmação da QITech que o desembolso foi concluído com sucesso, o status do empréstimo será alterado para “Desembolsado” (disbursed
). Se algum erro ocorrer, a mensagem da QITech será exibida como uma transação no histórico do empréstimo. É possível corrigir e fazer a reapresentação para desembolso.
Validação da chave PIX
A validação da chave PIX é feita no Portal do Cliente durante o fluxo de preenchimento dos dados bancários. A Base39 consulta a QITech para saber se a chave PIX é válida e se o banco é suportado. Se a chave for inválida ou o banco não for suportado, o cliente não poderá prosseguir com o preenchimento da solicitação.
Configuração na QITech
Chaves
A autenticação da QITech é feita através de chaves.
- Acesse o Portal QITech
- Clique em “Meu perfil” e depois na aba “Integração”
- Siga as instruções da QITech para gerar as chaves necessárias
- Use a API de Configurações para armazenar as chaves. Veja o cURL de exemplo.
- Use as mesmas chaves para configurar a consulta de chave PIX. Veja o cURL de exemplo.
Webhook
Os webhooks retornam informações sobre o status de desembolso. São essenciais para que a Base39 possa atualizar o status dos desembolsos e pendências.
- Crie uma chave de API restrita para o webhook da QITech através da API de Chaves. Veja o cURL de exemplo.
- Acesse o Portal QITech
- Clique em “Meu perfil” e depois na aba “Integração”
- Role até “Configurações de webhook”
- No campo URL, adicione a URL do webhook da Base39
https://api.base39.io/v1/webhooks/qitech
- No campo
headers
, adicione a chave de API criada no passo 1 e o nome da configuração usado no passo 4 da seção Chaves
{
"Authorization": "Bearer <chave-da-api>",
"Base39-Disbursement": "qitech"
}
Se você definiu o nome da configuração como qitech
, o valores devem ficar nesse formato:
![](https://mintlify.s3-us-west-1.amazonaws.com/base39/assets/images/integration-qitech-webhook.png)
Configuração de webhook no portal da QITech
A configuração deve ser aplicada ao clicar em “Salvar”.