---
title: "Initiate refund funds recovery [beta]"
method: POST
path: "/v1/pix/funds-recoveries/{funds_recovery_id}/refund"
tags: ["Funds recovery"]
---

# Initiate refund funds recovery \[beta\]

`POST /v1/pix/funds-recoveries/{funds_recovery_id}/refund`

## Request

- Base URL: `https://sandbox.pismolabs.io/pix-dict`
- URL: `https://sandbox.pismolabs.io/pix-dict/v1/pix/funds-recoveries/{funds_recovery_id}/refund`
- Auth: HTTP bearer

Initiate funds recovery refund stage, after the recipient PSPs have analyzed (`status` = `ANALYSED`) all the infraction notifications. This is the process' final step where funds are effectively returned to the victim's account.

Before requesting the refund, make sure that:

  * The recovery status = `ANALYSED`
  * You are the **creator** recovery participant
  * You are within the **72-hour** deadline after receiving the `FUNDS_RECOVERY_ANALYSED` event
  * There is at least one **accepted** infraction notification (status = `ACCEPTED`)

Thie endpoint generates a [Pix funds recovery status changed](https://developers.pismo.io/events/docs/pix-dict-funds-recoveries-status-change-1) event.

For more information refer to [Pix funds recovery](doc:pix-funds-recovery).

## Path parameters

- `funds_recovery_id` string, required

## Response `200`

OK - synchronous success

- InitiateFundsRecoveryResponse: Initiate funds recovery response
  - `funds_recovery_id` string: Funds recovery identifier. Returned from the [Create funds recovery](ref:post-create-funds-recovery) endpoint.
  - `status` 'CREATED' | 'AWAITING_ANALYSIS' | 'TRACKED' | 'ANALYSED' | 'REFUNDING' | 'COMPLETED' | 'CANCELLED': Funds recovery status: * `CREATED` - Recovery created, awaiting next action. * `TRACKED` - The transaction tracking graph has been created. * `AWAITING_ANALYSIS` - Awaiting analysis from receiver PSPs (deadline: 7 calendar days). * `ANALYSED` - Analysis completed, ready for refund. * `REFUNDING` - Refund process in progress. * `COMPLETED` - Recovery successfully completed. * `CANCELLED` - Recovery cancelled.
  - `total_refunds_created` integer: Total refunds created
  - `updated_at` string, date-time: Updated datetime. A RFC 3339 date-time value. For example - `2023-04-12T23:20:50.52Z`.

## Other responses

- `202`: Ok - Asynchronous success
- `400`: Invalid status
- `404`: No accepted infractions

---

[API](https://skmtc.dev/pismo/apis/instant-payments-pix-management.md) - [All operations](https://skmtc.dev/pismo/apis/instant-payments-pix-management/llms.txt) - [OpenAPI document](https://skmtc.dev/pismo/apis/instant-payments-pix-management/revisions/eb540c289547?raw)