---
title: "Create a customer bank account for refund payouts"
method: POST
path: "/api/v1/merchants/{merchantId}/customer-bank-accounts"
tags: ["Customer Bank Accounts"]
---

# Create a customer bank account for refund payouts

`POST /api/v1/merchants/{merchantId}/customer-bank-accounts`

Create a customer bank account for refund payouts

## Path parameters

- `merchantId` string, uuid, required — The unique identifier of the merchant

## Request body

- CustomerBankAccountInput — Customer bank account creation/update input
  - `account_holder_name` string, required — Name of the account holder
  - `customer_id` string, uuid — The customer who owns this bank account. Required when minting accounts outside the Flinks-linking flow.
  - `account_type` union — US ACH account type
    - 'checking'
    - 'savings'
  - `currency` string, required — The currency of the bank account
  - `country` string, required — The country of the bank account
  - `iban` string — The IBAN of the bank account
  - `account_number` string — The account number of the bank account
  - `sort_code` string — The sort code of the bank account (UK)
  - `routing_number` string — The routing number of the bank account (US)
  - `bban` string — Basic Bank Account Number (e.g., Norway)
  - `plusgiro_number` string — PlusGiro number (Sweden)
  - `bsb` string — Bank State Branch code (Australia)
  - `bic` string — The BIC/SWIFT code of the bank account

## Response `201`

Created

- CustomerBankAccountResponse
  - `success` boolean, required — Indicates if the request was successful
  - `data` object, required — Customer bank account information for refund payouts
    - `id` string, uuid, required — The unique identifier of the customer bank account
    - `currency` string, required — The currency of the bank account
    - `country` string, required — The country of the bank account
    - `status` string, required — The status of the bank account
    - `account_holder_name` string — Name of the account holder
    - `iban` string — The IBAN of the bank account
    - `account_number` string — The account number of the bank account
    - `sort_code` string — The sort code of the bank account (UK)
    - `routing_number` string — The routing number of the bank account (US)
    - `bban` string — Basic Bank Account Number (e.g., Norway)
    - `plusgiro_number` string — PlusGiro number (Sweden)
    - `bsb` string — Bank State Branch code (Australia)
    - `bic` string — The BIC/SWIFT code of the bank account
    - `created_at` string, date-time, required — The creation date of the bank account
    - `updated_at` string, date-time, required — The last update date of the bank account

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.net/banqzinc/apis/quidkey-api.md) · [All operations](https://skmtc.net/banqzinc/apis/quidkey-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/banqzinc/quidkey-api/revisions/f86d2bdbcb08/schema)