Webhooks

Uma vez que as transferências ocorrem de forma assíncrona, é de suma importância o mapeamento e o tratamento corretos dos webhooks enviados.

Atenção!

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

Webhook para criação da recorrência de Pix Automático

Webhook destinado com as informações de criação de recorrência do cliente

Webhook Request Body

Request Body: Criação de recorrência

{
    "webhook_type": "baas.automatic_pix.incoming_recurrence",
    "webhook_datetime": "2025-10-22T20:30:23.459Z",
    "data": {
        "account_key": "13385acf-b0c3-4389-baf3-a58abbe92d58",
        "incoming_recurrence_key": "12385acf-b0c3-4389-baf3-a58abbe92d58",
        "incoming_recurrence_status": "pending_confirmation"
    }
}

Webhook Body Param

Campo	Tipo	Descrição	Max. Caracteres
webhook_type	string	Um enumerador que define o tipo de evento sendo reportado	23
webhook_datetime	string	Data e hora do envio do webhook	20
account_key	uuid4	Chave única de identificação da conta.	36
incoming_recurrence_key	uuid4	Chave única de identificação da autorização	36
incoming_recurrence_status	string	Identificador de status da recorrência Pix.	pending_confirmation