Update Bank Account

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"
}
'

import requests

url = "https://api-staging.stablestack.com/api/payout/methods/banks/{payout_method_id}"

payload = {
    "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"
}
headers = {
    "x-api-key": "<x-api-key>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {'x-api-key': '<x-api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    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'
  })
};

fetch('https://api-staging.stablestack.com/api/payout/methods/banks/{payout_method_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api-staging.stablestack.com/api/payout/methods/banks/{payout_method_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    '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'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <x-api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api-staging.stablestack.com/api/payout/methods/banks/{payout_method_id}"

	payload := strings.NewReader("{\n  \"type\": \"BANK\",\n  \"account_name\": \"Updated Name\",\n  \"account_number\": \"9876543210\",\n  \"bank_name\": \"Updated Bank\",\n  \"currency\": \"NGN\",\n  \"bank_code\": \"000007\",\n  \"customer_id\": \"85b148ab-3f6b-4d55-917f-3c8de668a48e\",\n  \"sort_code\": \"202525\",\n  \"swift_code\": \"SWIFT123\",\n  \"routing_number\": \"ROUT456\",\n  \"iban\": \"IBAN789\"\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("x-api-key", "<x-api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.put("https://api-staging.stablestack.com/api/payout/methods/banks/{payout_method_id}")
  .header("x-api-key", "<x-api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"type\": \"BANK\",\n  \"account_name\": \"Updated Name\",\n  \"account_number\": \"9876543210\",\n  \"bank_name\": \"Updated Bank\",\n  \"currency\": \"NGN\",\n  \"bank_code\": \"000007\",\n  \"customer_id\": \"85b148ab-3f6b-4d55-917f-3c8de668a48e\",\n  \"sort_code\": \"202525\",\n  \"swift_code\": \"SWIFT123\",\n  \"routing_number\": \"ROUT456\",\n  \"iban\": \"IBAN789\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api-staging.stablestack.com/api/payout/methods/banks/{payout_method_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["x-api-key"] = '<x-api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"type\": \"BANK\",\n  \"account_name\": \"Updated Name\",\n  \"account_number\": \"9876543210\",\n  \"bank_name\": \"Updated Bank\",\n  \"currency\": \"NGN\",\n  \"bank_code\": \"000007\",\n  \"customer_id\": \"85b148ab-3f6b-4d55-917f-3c8de668a48e\",\n  \"sort_code\": \"202525\",\n  \"swift_code\": \"SWIFT123\",\n  \"routing_number\": \"ROUT456\",\n  \"iban\": \"IBAN789\"\n}"

response = http.request(request)
puts response.read_body

{
  "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"
}

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"
}
'

import requests

url = "https://api-staging.stablestack.com/api/payout/methods/banks/{payout_method_id}"

payload = {
    "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"
}
headers = {
    "x-api-key": "<x-api-key>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {'x-api-key': '<x-api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    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'
  })
};

fetch('https://api-staging.stablestack.com/api/payout/methods/banks/{payout_method_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api-staging.stablestack.com/api/payout/methods/banks/{payout_method_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    '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'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <x-api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api-staging.stablestack.com/api/payout/methods/banks/{payout_method_id}"

	payload := strings.NewReader("{\n  \"type\": \"BANK\",\n  \"account_name\": \"Updated Name\",\n  \"account_number\": \"9876543210\",\n  \"bank_name\": \"Updated Bank\",\n  \"currency\": \"NGN\",\n  \"bank_code\": \"000007\",\n  \"customer_id\": \"85b148ab-3f6b-4d55-917f-3c8de668a48e\",\n  \"sort_code\": \"202525\",\n  \"swift_code\": \"SWIFT123\",\n  \"routing_number\": \"ROUT456\",\n  \"iban\": \"IBAN789\"\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("x-api-key", "<x-api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.put("https://api-staging.stablestack.com/api/payout/methods/banks/{payout_method_id}")
  .header("x-api-key", "<x-api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"type\": \"BANK\",\n  \"account_name\": \"Updated Name\",\n  \"account_number\": \"9876543210\",\n  \"bank_name\": \"Updated Bank\",\n  \"currency\": \"NGN\",\n  \"bank_code\": \"000007\",\n  \"customer_id\": \"85b148ab-3f6b-4d55-917f-3c8de668a48e\",\n  \"sort_code\": \"202525\",\n  \"swift_code\": \"SWIFT123\",\n  \"routing_number\": \"ROUT456\",\n  \"iban\": \"IBAN789\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api-staging.stablestack.com/api/payout/methods/banks/{payout_method_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["x-api-key"] = '<x-api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"type\": \"BANK\",\n  \"account_name\": \"Updated Name\",\n  \"account_number\": \"9876543210\",\n  \"bank_name\": \"Updated Bank\",\n  \"currency\": \"NGN\",\n  \"bank_code\": \"000007\",\n  \"customer_id\": \"85b148ab-3f6b-4d55-917f-3c8de668a48e\",\n  \"sort_code\": \"202525\",\n  \"swift_code\": \"SWIFT123\",\n  \"routing_number\": \"ROUT456\",\n  \"iban\": \"IBAN789\"\n}"

response = http.request(request)
puts response.read_body

{
  "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

Show child attributes

message

string

Example:

"Bank account updated successfully"

API Documentation

Customers

Wallet Assets

Wallets

Banks

Beneficiary

Payouts

Transactions

Key Features:

Request Parameters:

Request Body:

Headers

Path Parameters

Body

Response

​Key Features:

​Request Parameters:

​Request Body:

Headers

Path Parameters

Body

Response

Key Features:

Request Parameters:

Request Body: