Delete a recipient

curl --request DELETE \
  --url https://business.madhousewallet.com/api/payouts/recipients/{id} \
  --header 'Authorization: Bearer <token>'

{
  "deleted": true,
  "id": "12345678",
  "transfers_failed": 0
}

Recipients

Delete a recipient

Deactivates a payout recipient. The recipient must belong to your account. Deleted recipients cannot be used in future transfers.

wallet is a conditionally required query-string parameter (DELETE requests carry no body): it is only needed if your account requires KYC verification. When required, it must be a KYC-verified wallet — unverified wallets are rejected with 403 (verify at kyc.madhousewallet.com). If KYC is not enabled for your account, it may be omitted.

If any transfers for this recipient are still in progress (not yet completed or failed), they are immediately marked as failed before deletion proceeds. The transfers_failed field in the response indicates how many transfers were cancelled. Associated deposit wallets created by the platform are cleaned up automatically.

Rate limit: 30 requests/minute.

DELETE

api

payouts

recipients

{id}

Delete a recipient

curl --request DELETE \
  --url https://business.madhousewallet.com/api/payouts/recipients/{id} \
  --header 'Authorization: Bearer <token>'

{
  "deleted": true,
  "id": "12345678",
  "transfers_failed": 0
}

Authorizations

Authorization

string

header

required

Pass your API key as a Bearer token: Authorization: Bearer mw_live_<keyId>_<secret>

Path Parameters

integer

required

Recipient account ID

Example:

12345678

Query Parameters

wallet

string

Your wallet address (EVM 0x + 40 hex, or Solana base58 32–44 chars). Conditionally required: only needed if your account requires KYC verification, in which case it must be a KYC-verified wallet. May be omitted if KYC is not enabled for your account.

Example:

"0xAb5801a7D398351b8bE11C439e05C5B3259aeC9B"

Response

Recipient deleted

deleted

boolean

Example:

true

string

Example:

"12345678"

transfers_failed

integer

Number of in-progress transfers that were cancelled (marked failed) as a result of this deletion. 0 means no transfers were in flight.

Example:

0

Update a recipient

⌘I