Skip to main content
DELETE
Delete recipient

Overview

Soft-delete a recipient. The recipient will no longer appear in list results and cannot be used for new transfers or settlement destinations. This action is irreversible.

Authentication

X-Api-Key
string
required
Your merchant API key

Path Parameters

id
string
required
Recipient ID (UUID)Example: 750e8400-e29b-41d4-a716-446655440000

Request Example

Response

A successful deletion returns a 204 No Content response with an empty body.

Success Response

Error Responses

Notes

  • This is a soft-delete operation. The recipient record is retained internally but is no longer accessible via the API.
  • Any in-progress movements referencing this recipient will not be affected.
  • Deleting a recipient that has already been deleted will return a 404 Not Found error.

Next Steps

Create recipient

Create a new recipient

List recipients

Retrieve all saved recipients