Skip to main content
PUT
/
payout
/
methods
/
banks
/
{payout_method_id}
Update bank payout method
curl --request PUT \
  --url https://api-staging.stablestack.com/api/payout/methods/banks/{payout_method_id} \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "type": "BANK",
  "account_name": "Updated Name",
  "account_number": "9876543210",
  "bank_name": "Updated Bank",
  "currency": "NGN",
  "bank_code": "000007",
  "customer_id": "85b148ab-3f6b-4d55-917f-3c8de668a48e",
  "sort_code": "202525",
  "swift_code": "SWIFT123",
  "routing_number": "ROUT456",
  "iban": "IBAN789"
}
'
{
  "status": "success",
  "data": {
    "id": "b6d3af87-e67f-42a2-b24a-d33f220a0d37",
    "type": "BANK",
    "currency": "USD",
    "account_name": "Updated Name",
    "account_number": "9876543210",
    "bank_name": "Updated Bank",
    "bank_code": "000007",
    "sort_code": "202525",
    "swift_code": "SWIFT123",
    "routing_number": "ROUT456",
    "iban": "IBAN789",
    "created_at": "2025-05-12T15:30:56.623Z",
    "updated_at": "2025-05-20T10:15:45.123Z",
    "customer_id": "85b148ab-3f6b-4d55-917f-3c8de668a48e"
  },
  "message": "Bank account updated successfully"
}
Updates an existing bank payout method (either merchant-owned or customer-specific).

​
Key Features:

  • Supports partial updates - only include fields that need to be modified
  • Include customer_id only when updating customer-specific bank accounts
  • Returns the complete updated bank account object

​
Request Parameters:

  • payout_method_id (path, required): The ID of the bank account to update

​
Request Body:

{
  "customer_id": "85b148ab-3f6b-4d55-917f-3c8de668a48e", // optional
  "account_name": "Updated Name",
  "account_number": "9876543210",
  "bank_name": "Updated Bank",
  "currency": "USD",
  "bank_code": "000007",
  "sort_code": "202525", // optional
  "swift_code": "SWIFT123", // optional
  "routing_number": "ROUT456", // optional
  "iban": "IBAN789" // optional
}

Headers

​
x-api-key
string
required

Path Parameters

​
payout_method_id
string<uuid>
required

ID of the bank account to update

Body

application/json
​
type
enum<string>
default:BANK
required

Must be 'BANK' for this endpoint

Available options:
BANK
​
account_name
string
required
Example:

"Updated Name"

​
account_number
string
required
Example:

"9876543210"

​
bank_name
string
required
Example:

"Updated Bank"

​
currency
enum<string>
required
Available options:
NGN,
ZAR
Example:

"NGN"

​
bank_code
string
required
Example:

"000007"

​
customer_id
string | null

Required only when updating customer-specific bank account

Example:

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

​
sort_code
string
Example:

"202525"

​
swift_code
string
Example:

"SWIFT123"

​
routing_number
string
Example:

"ROUT456"

​
iban
string
Example:

"IBAN789"

Response

Bank account updated successfully

​
status
string
Example:

"success"

​
data
object
​
message
string
Example:

"Bank account updated successfully"