Process a refund for a charged application

Processes a refund for a previously charged application. This operation reverses the charge and updates the application status. Accepted application statuses: APPROVED or FUNDED. Refund window: refunds are accepted only within 20 days of the application signing date (signed_at). Requests outside this window are rejected with 409 CONFLICT. Amount validation: if the requested amount exceeds the remaining refundable balance (principal minus all prior refunds), the request is rejected with 409 CONFLICT. The balance is never silently reduced — the partner must request a corrected amount. pix_key and pix_key_type are optional. If not provided and a PIX transfer to the customer is needed (transfer_amount > 0), the refund transitions to ACTION_REQUIRED. Use PUT /application/{id}/refund/{refund_id} to supply the PIX key later. refund_type is optional. If omitted, it is deduced automatically: FULL when the cumulative refunds cover the full principal, PARTIAL otherwise. Credit limit: released immediately when the refund is created — a refund.limit_restored webhook is dispatched at this point regardless of refund status or PIX key. Status flow: PENDINGCOMPLETED (no transfer needed) | ACTION_REQUIRED (transfer needed, no PIX key) | LIMIT_RESTORED (transfer needed, PIX key provided)

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
uuid
required

Application identifier

Body Params
double
required

Refund amount in BRL

string

Reason for the refund

string

PIX key value to receive the refund (optional; if not provided the refund may require a follow-up ACTION_REQUIRED step)

string
enum

Type of the PIX key provided (optional; required when pix_key is provided)

Show Details
CPFIndividual taxpayer ID (e.g., `111.111.111-11` or `11111111111`)
CNPJCompany taxpayer ID (14 digits, e.g., 11.111.111/0001-11)
EMAILEmail address (e.g., [email protected])
PHONEPhone number with country code (e.g., +5511999999999)
EVPRandom key generated by the bank (UUID format)
Allowed:
string
enum

Type of refund. Optional — if omitted, the type is deduced automatically: FULL when the refund amount is greater than or equal to the outstanding balance, PARTIAL otherwise.

Show Details
FULLFull refund of the entire loan amount
PARTIALPartial refund of a specific amount (e.g., product return)
Allowed:
string
enum

Standardized reason code for the refund

Show Details
CUSTOMER_REQUESTCustomer requested cancellation/refund
PRODUCT_RETURNCustomer returned the purchased product(s)
DUPLICATE_CHARGEDuplicate charge was detected
FRAUDTransaction flagged as fraudulent
OTHEROther reason (specify in the 'reason' field)
Allowed:
string

Partner-provided reference ID for this refund, used for reconciliation

Responses

Language
Credentials
Bearer
JWT
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json