Update merchant withdrawal method
Updates a saved withdrawal method. Only label and details may be changed — methodType and merchantId are immutable. Changing details resets the method to "cooling" and starts a new cooling period for fraud protection.
Authorization
bearer In: header
Path Parameters
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
curl -X PATCH "https://<api-host>/v1/merchant-withdrawal-methods/string" \ -H "Content-Type: application/json" \ -d '{}'{
"data": {
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"tenantId": "f97df110-f4de-492e-8849-4a6af68026b0",
"livemode": true,
"merchantId": "c3073b9d-edd0-49f2-a28d-b7ded8ff9a8b",
"methodType": "string",
"label": "string",
"details": {
"property1": "string",
"property2": "string"
},
"status": "cooling",
"activatesAt": "string",
"createdAt": "string",
"updatedAt": "string",
"deletedAt": null
}
}Soft delete merchant withdrawal method
Marks a saved withdrawal method as deleted. The record is preserved for audit (soft delete) but cannot be used for new withdrawals. Does not affect withdrawals already in flight that reference this method.
Cancel withdrawal
Cancels a withdrawal initiated by the requesting entity. Allowed from `pending` or `approved` states. If the withdrawal was approved (funds reserved), cancellation reverses the payable entries and restores the available balance.