銀行口座

銀行口座オブジェクトは、支払い送金に使用される銀行口座の詳細を表します。このオブジェクトは、TransferまたはTransferスケジュールのRecipientを作成する際に使用されます。

概要

銀行口座はAPIを通じて直接作成されません。代わりに、以下の操作の一部として作成されます：

• Recipientの作成 - Recipient作成時に銀行口座の詳細を提供
• Recipientの更新 - 既存のRecipientの銀行口座情報を更新

オブジェクト構造

属性	型	説明
object	string	オブジェクトタイプ。常にbank_accountです。
livemode	boolean	本番モードかどうかを示します。
brand	string	銀行のブランド名（例：bbl、kbank、scb）。
bank_code	string	銀行を識別するコード。
branch_code	string	支店コード（日本など一部の国で必須）。
account_number	string	マスクされた口座番号（セキュリティのため）。
last_digits	string	口座番号の下4桁。
name	string	銀行口座の名義人名。
type	string	口座タイプ（normalまたはcurrent）。日本で必須。
created_at	string	ISO 8601形式のオブジェクト作成日時。

レスポンス例

{
  "object": "bank_account",
  "livemode": false,
  "brand": "kbank",
  "bank_code": "004",
  "branch_code": null,
  "account_number": "xxx-x-x1234-x",
  "last_digits": "1234",
  "name": "JOHN DOE",
  "type": null,
  "created_at": "2025-02-07T00:00:00Z"
}

サポートされている銀行

タイ

一般的な銀行コード：

Bank Code	Bank Name
bbl	Bangkok Bank
kbank	Kasikornbank
scb	Siam Commercial Bank
ktb	Krung Thai Bank
bay	Bank of Ayudhya (Krungsri)
tmb	TMB Bank
citi	Citibank
smbc	Sumitomo Mitsui Banking Corporation
sc	Standard Chartered

日本

日本の銀行口座には追加フィールドが必要です：

• branch_code - 支店コード（必須）
• type - 口座タイプ（normalまたはcurrent、必須）

その他の対応国

• シンガポール - 現地銀行対応
• マレーシア - 現地銀行対応
• インドネシア - 現地銀行対応

サポートされている銀行の完全なリストについては、Capability APIを確認してください。

関連エンドポイント

• Recipientの作成 - 銀行口座詳細を含む新しいRecipientを作成
• Recipientの更新 - 既存のRecipientの銀行口座情報を更新
• Transferの作成 - Recipientの銀行口座にTransferを作成
• Capabilityの取得 - サポートされている銀行を確認

関連リソース

• Recipients API - Recipientと銀行口座を管理
• Transfers API - Recipientに資金を送金
• Balance API - 利用可能残高を確認

---

サポートが必要ですか？ 銀行口座の設定、サポートされている銀行、またはTransferの統合についてはsupport@omise.coまでお問い合わせください。