---
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/passport`
- URL: `https://sandbox.pismolabs.io/passport/v1/pix/funds-recoveries/{funds_recovery_id}/refund`
- Auth: none declared

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](https://developers.pismo.io/pismo-docs/docs/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](https://developers.pismo.io/pismo-docs/reference/post-create-funds-recovery) endpoint.
  - `status` 'CREATED' | 'AWAITING_ANALYSIS' | 'TRACKED' | 'ANALYSED' | 'REFUNDING' | 'COMPLETED' | 'CANCELLED': Funds recovery status: * `CREATED` - For `INTERACTIVE` * `AWAITING_ANALYSIS` - For `AUTOMATED` when processed synchronously * `CREATED` - Recovery created, awaiting next action. Both flows. * `TRACKED` - Tracking graph created. `INTERACTIVE` only * `AWAITING_ANALYSIS` - Awaiting analysis from receiver PSPs (deadline: 7 days). Both flows. * `ANALYSED` - Analysis completed, ready for refund. Both flows * `REFUNDING` - Refund process in progress. Both flows. * `COMPLETED` - Recovery successfully completed. Both flows. * `CANCELLED` - Recovery cancelled. Both flows.
  - `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/platform-authentication.md) - [All operations](https://skmtc.dev/pismo/apis/platform-authentication/llms.txt) - [OpenAPI document](https://skmtc.dev/pismo/apis/platform-authentication/revisions/935b62e16de4?raw)