Pular para o conteúdo principal

Webhooks de dívida

Informação

O timeout para resposta de nosso webhooks é de 5 segundos.

Atenção!

Os webhooks da QI Tech não devem ser mapeadas de forma restrita. Campos adicionais podem ser incluídos aos payloads dos webhooks retornados em nossas APIs.

Webhook de assinatura finalizada​

Response Body
{
    "key": "ebe12ca1-ec34-4674-bd62-24c0bc204e81",
    "status": "signature_finished",
    "webhook_type": "debt",
    "event_datetime": "2024-09-02 18:39:49",
    "signed_contract_url": "https://storage.googleapis.com/live-doc-api/documents/6099edd7-1c83-4890-998e-ce60e218523cb/S_signed.pdf"
}

Webhook de desembolso.​

Response Body
{
    "key": "871059bd-4014-41ad-82b4-28275ff0e67b",
    "data": {
        "installments": [{
            "due_date": "2022-09-29",
            "qr_code_key": "871059bd-4014-41ad-82b4-28275ff0e67b",
            "qr_code_url": "https://qitech.com.br/",
            "bank_slip_key": "871059bd-4014-41ad-82b4-28275ff0e67b",
            "digitable_line": "32990001031000699920446000000201991230000019896"
        }, {
            "due_date": "2022-10-31",
            "qr_code_key": "871059bd-4014-41ad-82b4-28275ff0e67b",
            "qr_code_url": "https://qitech.com.br/",
            "bank_slip_key": "243f9441-872a-4d64-886c-2f9724c36f2e",
            "digitable_line": "32990001031000699920447000000209191550000019896"
        }, {
            "due_date": "2022-11-29",
            "qr_code_key": "871059bd-4014-41ad-82b4-28275ff0e67b",
            "qr_code_url": "https://qitech.com.br/",
            "bank_slip_key": "871059bd-4014-41ad-82b4-28275ff0e67b",
            "digitable_line": "32990001031000699920448000000207891840000019896"
        }, {
            "due_date": "2022-12-29",
            "qr_code_key": "871059bd-4014-41ad-82b4-28275ff0e67b",
            "qr_code_url": "00020126970014br.gov.bcb.pix2575qrcode-h.sandbox.qitech.app/bacen/cobv/cf7d2d2e-003a-4296-9daf-350864d282245204000053039865802BR5925QI SOCIEDADE DE CREDITO D6009Sao Paulo61080145200062070503***63047335",
            "bank_slip_key": "871059bd-4014-41ad-82b4-28275ff0e67b",
            "digitable_line": "32990001031000699920449000000205892140000019896"
        }, {
            "due_date": "2023-01-30",
            "qr_code_key": "e809ffca-ac2f-4a51-9f4f-df7ffc4de8e3",
            "qr_code_url": "https://qitech.com.br/",
            "bank_slip_key": "871059bd-4014-41ad-82b4-28275ff0e67b",
            "digitable_line": "32990001031000699920450000000203792460000019892"
        }],
        "ted_receipt_list": [{
            "fee": 0,
            "url": "https://qitech.com.br/",
            "amount": 500,
            "origin": {
                "name": "QI SOCIEDADE DE CRÉDITO DIRETO S.A.",
                "type": "payment_account",
                "branch": "0001",
                "document": "0000000000000",
                "bank_code": "000",
                "account_key": "871059bd-4014-41ad-82b4-28275ff0e67b",
                "branch_digit": null,
                "account_digit": "5",
                "account_branch": "0001",
                "account_number": "00002"
            },
            "timestamp": "2022-09-28T13:00:47",
            "description": "DESCRIPTION",
            "destination": {
                "name": "QI TECH",
                "type": "checking_account",
                "branch": "0000",
                "purpose": "Crédito PIX em Conta",
                "document": "000000000000000",
                "bank_ispb": "00000000",
                "branch_digit": null,
                "account_digit": "0",
                "account_number": "00000000"
            },
            "end_to_end_id": null,
            "transaction_key": "871059bd-4014-41ad-82b4-28275ff0e67b",
            "origin_transaction_key": null
        }],
        "requester_identifier_key": "57f8e1ce-1080-4d0d-a195-89709b961561"
    },
    "status": "disbursed",
    "webhook_type": "debt",
    "event_datetime": "2022-09-28 13:01:23"
}

Webhook de cancelamento.​

Response Body
{
     "webhook_type": "debt",
     "key":"27a099df-4688-43cb-87fa-515b1cf343a5",
     "event_datetime": "2022-09-27 07:03:49",
    "data": {
        "cancel_reason": "Operacao cancelada manualmente",
        "cancel_reason_enumerator": "manual"
    },
     "status":"canceled "
  }

Webhook de contrato quitado:​

Response Body
{
    "key": "27a099df-4688-43cb-87fa-515b1cf343a5",
    "data": {
        "settlement_amount": 3429.38
    },
    "status": "settled",
    "webhook_type": "debt",
    "event_datetime": "2022-09-27 07:03:49"
}

Motivos de cancelamento​

cancel_reason_enumeratorDescrição
disbursing_errorOperação cancelada por erro no momento do desembolso.
waiting_signatureOperação cancelada por falta de assinatura.
is_portabilityA operação foi cancelada pois é uma portabilidade que não foi concluída.
not_collateral_constitutedA operação foi cancelada pois as garantias não foram constituídas.
entry_not_paidA operação foi cancelada pois a entrada não foi paga.
not_assignedOperação foi cancelada porque o processo de cessão não foi realizado.
pix_max_retryOperação cancelada pois o banco recebedor não conseguiu receber o desembolso.
lack_of_resourceOperação cancelada por falta de recurso.
manualOperação cancelada manualmente.
kyc_not_acceptedOperação cancelada pois não foi aprovada no compliance.
not_collateral_fgtsOperação cancelada por erro com FTGS.
agencia_conta_invalidaAgência ou Conta Destinatária do Crédito Inválida.
not_assignedOperação foi cancelada porque o processo de cessão não foi realizado.
invalid_accountNúmero da conta de destino é inexistente ou inválido.
invalid_document_numberCPF/CNPJ da conta de destino está incorreto.
unsupported_transactionA conta de destino não suporta este tipo de transação.
bank_slip_paymentOperação cancelada por erro no pagamento do boleto.
bank_slip_paidOperação cancelada pois o boleto já está pago.
bank_slip_written_offOperação cancelada pois o boleto já está baixado.
invalid_ispbNúmero ISPB é inválido ou inexistente.
rejected_paymentOrdem de pagamento foi rejeitada pelo banco recebedor.