Estorno BNPL

Resumo

O estorno de uma operação BNPL permite reverter o desembolso realizado. Existem dois 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 (até 7 dias): Gera um Pix de devolução para que o tomador retorne os recursos

---

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 (Até 7 Dias)

Realiza o estorno de uma operação BNPL já desembolsada, dentro do prazo de 7 dias corridos após o desembolso. O sistema gera um Pix copia-e-cola para que o tomador devolva os recursos.

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