Create Pix Fund Recovery Request
POST/v1/pix/fund-recovery-requests
Create a pix fund recovery request. Sends a create pix fund recovery to DICT. Returns the pix fund recovery request with a state of CREATED.
Request
Header Parameters
The transaction ID is a UUID (v4) used to uniquely identify the object that will be created. All objects must have an identifier.
Sender Wallet UUID (if empty, your default Wallet UUID will be settled)
The nonce ID is a UUID (v4) used to uniquely identify the request. All requests must have an identifier.
UUID (v4) of the product that the request should use. Send it explicitly when the authenticated user has more than one product or when the integration must select a specific product. If omitted and the endpoint does not require it, the API uses the authenticated user's default product.
UUID (v4) of the user on whose behalf the request should run within the selected product. If omitted, the request runs as the authenticated user. Requires x-product-uuid.
Possible values: [pt-BR, en-US]
Indicates the preferred language. Defaults to Brazilian Portuguese if unspecified.
- application/json
Body
required
Pix Fund Recovery Request transaction operation ID.
Pix Fund Recovery Request transaction ID.
Possible values: [FRAUD, CANCEL_DEVOLUTION, PIX_AUTOMATIC_FRAUD, PIX_AUTOMATIC_PSP_ERROR]
Pix Fund Recovery Request reason.
Possible values: [FRAUD, UNAUTHORIZED, COERSION_CRIME, FRAUDULENT_ACCESS, OTHER, UNKNOWN]
Pix Fund Recovery Request fraud reason.
Pix Fund Recovery Request description.
Responses
- 200
- 400
- 401
- 404
- 422
The pix fund recovery request returned successfully.
- application/json
- Schema
- Example (from schema)
Schema
Pix Fund Recovery Request ID.
Pix Fund Recovery Request created at.
{
"id": "f6e2e084-29b9-4935-a059-5473b13033aa",
"created_at": "2026-11-05T12:35:08.184Z"
}
If any required params are missing or has invalid format or type.
User authentication failed.
If the pix fund recovery request id was not found.
If any required params are missing or has invalid format or type.