Estorno BNPL

Resumo

O estorno de uma operação BNPL permite reverter o desembolso realizado. Existem três cenários de cancelamento/estorno:

1. Cancelamento antes do desembolso: Cancela a operação antes que os recursos sejam transferidos
2. Estorno após o desembolso — via Pix de devolução (até 7 dias): Gera um Pix copia-e-cola para que o tomador devolva os recursos
3. Estorno após o desembolso — via conta interna QI: A devolução é feita diretamente pela conta interna da QI Tech, sem ação do tomador

---

1. Cancelamento Antes do Desembolso

Cancela uma operação de crédito que ainda não foi desembolsada.

Request

ENDPOINT

/debt/DEBT-KEY/cancel

MÉTODO

PATCH

Testar no Playground

Path Params

Campo	Tipo	Descrição	Caracteres
debt_key*	string	Chave única da dívida retornada no momento da criação da operação de crédito	UUID

Response

STATUS

200

Response Body

{}

Atenção

Este endpoint só pode ser utilizado para operações que ainda não foram desembolsadas. Para operações já desembolsadas, utilize o endpoint de estorno abaixo.

---

2. Estorno Após o Desembolso — Via Pix de Devolução (Até 7 Dias)

Utilizado quando o parceiro deseja solicitar ao tomador que devolva os recursos via Pix. O sistema gera um Pix copia-e-cola para que o tomador realize a devolução. Assim que o pagamento é confirmado, a operação é cancelada automaticamente.

Quando usar

Use este endpoint quando o estorno deve ser realizado pelo próprio tomador, que receberá um Pix de devolução para pagar.

Request

ENDPOINT

/debt/reversal

MÉTODO

POST

Testar no Playground

Request Body

{
    "credit_operation_key": "72760166-4ddf-41fb-8a8c-605f8f4fc35c"
}

Body Params

Campo	Tipo	Descrição	Caracteres
credit_operation_key*	string	Chave da operação de crédito (DEBT-KEY)	UUID

Response

STATUS

200

Response Body

{
    "payer_name": "Dante Ferrarini",
    "payer_document_number": "31057466093",
    "amount": 1000,
    "expiration_date": "2026-04-28",
    "copy_paste_pix": "00020126930014br.gov.bcb.pix2571qrcode-h.sandbox.qitech.app/bacen/cobv/fb1906ab2eff40109609855ac104f60e5204000053039865802BR5925QISOCIEDADEDECREDITODIRET6008SaoPaulo61080145200062070503***63046387",
    "reversal_key": "7a18fdb6-a3e7-4fc9-833e-0f6d8e98de3b",
    "status": "active",
    "debt_key": "72760166-4ddf-41fb-8a8c-605f8f4fc35c",
    "qr_code_key": "fb1906ab-2eff-4010-9609-855ac104f60e"
}

Detalhes do Response

Campo	Tipo	Descrição
payer_name	string	Nome do tomador
payer_document_number	string	CPF/CNPJ do tomador
amount	float	Valor total a ser devolvido
expiration_date	string	Data de expiração do Pix de devolução
copy_paste_pix	string	Código Pix copia-e-cola para devolução dos recursos
reversal_key	string	Chave única do estorno (UUID)
status	string	Status do estorno: active
debt_key	string	Chave da dívida (DEBT-KEY)
qr_code_key	string	Chave do QR Code Pix (UUID)

Importante

• O estorno só pode ser realizado dentro de 7 dias corridos após o desembolso
• O copy_paste_pix gerado possui uma data de expiração. Após essa data, o Pix não poderá mais ser utilizado
• Após o pagamento do Pix pelo tomador, a operação será cancelada automaticamente e você receberá um webhook de cancelamento

---

3. Estorno Após o Desembolso — Via Conta Interna QI

Utilizado quando a devolução dos recursos é realizada diretamente pela conta interna da QI Tech, sem necessidade de ação do tomador. Indicado para o método internal, onde o valor é debitado internamente sem geração de Pix.

Quando usar

Use este endpoint quando o estorno é operado pelo parceiro via conta interna da QI Tech, sem envolver o tomador no processo de devolução.

Request

ENDPOINT

/credit_operation/CREDIT-OPERATION-KEY/reversal

MÉTODO

PUT

Header obrigatório

Envie o header SELECTED-AGENT com o valor do seu requester_key.

Path Params

Campo	Tipo	Descrição	Caracteres
credit_operation_key*	string	Chave da operação de crédito (DEBT-KEY)	UUID

Request Body (opcional)

{
    "cancel_reason": "reversed_manually"
}

Body Params

Campo	Tipo	Descrição	Caracteres
cancel_reason	string	Motivo do estorno. Se não informado, o sistema utilizará o padrão.	-