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.

Pela API

1. Acesse o Portal QITech
2. Clique em “Meu perfil” e depois na aba “Integração”
3. Siga as instruções da QITech para gerar as chaves necessárias
4. Use a API de Configurações para armazenar as chaves. Veja o cURL de exemplo.

cURL de exemplo da configuração de desembolso

curl --request POST \
    --url https://api.base39.io/v1/settings \
    --header 'authorization: Basic <sua-api-key>' \
    --data '
    {
      "disbursements": {
        "qitech": { // nome da configuração
          "type": "qitech",
          "credentials": {
            "url": "https://api-auth.sandbox.qitech.app",
            "apiKey": "abcdef12345",
            "privateKey": "-----BEGIN RSA PRIVATE KEY-----\\nMIIBOgIBAAJBA1iL+YC+dr4jm\\nkSU1rAs8czUpBHZj/0nagBmBHgjP5W/Q9fkCAwEAAQJAMtWs6j3ytIbJ4CofHAy5\\nD+aiZ+QqGMi8DqR8Vogea8E\\nAQIhAOZCyFD4Bhsc6Wsl8\\nyW7qYMtLljpBUdy0C5cnC9xzI\\n6nNhbeQIhANv2\\n+R0S0bz+my50DL\\n-----END RSA PRIVATE KEY-----",
            "publicKey": "-----BEGIN PUBLIC KEY-----\\nMFwwDQQ4zcUC9\\noQXSxo5c1iL+YC+dr4jmkCAwEAAQ==\\n-----END PUBLIC KEY-----",
            "ccbPrefix": "string" // consulte o time QITech para saber o valor
          },
          "supportedPaymentMethods": [
            "paymentMethod.pix",
            "boleto",
            "invoice"
          ]
        }
      }
    }
    '

5. Use as mesmas chaves para configurar a consulta de chave PIX. Veja o cURL de exemplo.

cURL de exemplo da consulta de chave PIX

curl --request POST \
    --url https://api.base39.io/v1/settings \
    --header 'authorization: Basic <sua-api-key>' \
    --data '
    {
      "validations": {
        "pix": {
          "type": "qitech",
          "credentials": {
            "url": "https://api-auth.sandbox.qitech.app",
            "apiKey": "abcdef12345",
            "privateKey": "-----BEGIN RSA PRIVATE KEY-----\\nMIIBOgIBAAJBA1iL+YC+dr4jm\\nkSU1rAs8czUpBHZj/0nagBmBHgjP5W/Q9fkCAwEAAQJAMtWs6j3ytIbJ4CofHAy5\\nD+aiZ+QqGMi8DqR8Vogea8E\\nAQIhAOZCyFD4Bhsc6Wsl8\\nyW7qYMtLljpBUdy0C5cnC9xzI\\n6nNhbeQIhANv2\\n+R0S0bz+my50DL\\n-----END RSA PRIVATE KEY-----",
            "publicKey": "-----BEGIN PUBLIC KEY-----\\nMFwwDQQ4zcUC9\\noQXSxo5c1iL+YC+dr4jmkCAwEAAQ==\\n-----END PUBLIC KEY-----",
            "ccbPrefix": "string", // consulte o time QITech para saber o valor
            "passphrase": "string" // opcional
          }
        }
      }
    }
    '

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.

Pela API

1. Crie uma chave de API restrita para o webhook da QITech através da API de Chaves. Veja o cURL de exemplo.

cURL de exemplo da consulta de chave PIX

curl --request POST \
    --url https://api.base39.io/v1/tenants/api-keys \
    --header 'authorization: Basic <sua-api-key>' \
    --data '
    {
      "name": "<nome>",
      "email": "<email>",
      "rules": [
        {
          "rule": "readOnly",
          "resource": "/v1/webhooks/qitech"
        }
      ]
    }
    '

2. Acesse o Portal QITech
3. Clique em “Meu perfil” e depois na aba “Integração”
4. Role até “Configurações de webhook”
5. No campo URL, adicione a URL do webhook da Base39 https://api.base39.io/v1/webhooks/qitech
6. 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:

Configuração de webhook no portal da QITech

A configuração deve ser aplicada ao clicar em “Salvar”.

O nome da configuração é usado para suportar cenários onde você precisa ter mais de uma conta na QItech.