List merchant withdrawal methods
Returns a paginated list of saved withdrawal methods visible to the caller. Filters: merchantId, methodType, status. Rows always belong to the caller mode. Cursor-based pagination — default page size 20, maximum 100.
Authorization
bearer In: header
Query Parameters
Filter by merchant ID (UUID v7).
uuidFilter by catalog type key (e.g. "sepa_bank_transfer").
Filter by lifecycle status (cooling, active, suspended).
"cooling" | "active" | "suspended"Accepted for compatibility. Methods always belong to the caller mode.
"true" | "false"Pagination cursor from a previous list response.
uuidPage size. Default 20, maximum 100.
201 <= value <= 100Sort by createdAt. Defaults to descending (newest first).
"asc" | "desc"Response Body
application/json
curl -X GET "https://<api-host>/v1/merchant-withdrawal-methods"{
"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
}
],
"pagination": {
"nextCursor": "string",
"prevCursor": "string",
"hasMore": true,
"totalCount": 0
}
}Get merchant withdrawal method by ID
Returns the full details of a saved withdrawal method, including its catalog type, details, status, and cooling-period timestamp. Returns 404 if the method does not exist or is not visible to the caller.
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.