Skip to main content
DELETE
/
payout
/
methods
/
{payout_method_id}
Delete payout method
curl --request DELETE \
  --url https://api-staging.stablestack.xyz/api/payout/methods/{payout_method_id} \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '{
  "customer_id": "85b148ab-3f6b-4d55-917f-3c8de668a48e"
}'
{
  "status": "success",
  "message": "Merchant payout method deleted successfully"
}
Permanently deletes a payout method.

​
Key Features:

  • Deletes both merchant-owned and customer-specific payout methods
  • For merchant methods: No request body required
  • For customer methods: Must include customer_id in request body
  • Returns appropriate success message based on method ownership
  • Returns 404 if payout method doesn’t exist or access denied

​
Request:

Path Parameters:
  • payout_method_id: UUID of the payout method to delete
Request Body (for customer methods only): 
{
  "customer_id": "85b148ab-3f6b-4d55-917f-3c8de668a48e"
}

Headers

​
x-api-key
string
required

Path Parameters

​
payout_method_id
string<uuid>
required

ID of the payout method to delete

Body

application/json
​
customer_id
string<uuid>

Required only when deleting customer-specific payout method

Example:

"85b148ab-3f6b-4d55-917f-3c8de668a48e"

Response

Payout method deleted successfully

​
status
string
Example:

"success"

​
message
string
Example:

"Payout method deleted successfully"