銀行口座
銀行口座とは、売上金の振込先銀行口座です。マーチャントコンソールで銀行口座を登録、編集、削除することができます。
最大10個の銀行口座を登録することができますが、プライマリーに指定できるのは1個だけです。プライマリー銀行口座とは、次の支払いサイクルで使用される口座です。
銀行口座は、new
状態で始まり、送金が完了するとverified
状態に変更されます。送金ができない場合は、unable_to_verify
状態になり、ウェブフックの指定先に通知されます。 以前に送金を行ったことがある口座で送金できないことが続いた場合、errored
状態に変更されます。
銀行口座のオブジェクト
Fields | |
---|---|
id | string (UUID) 銀行口座のユニークID |
holder_name | string 銀行口座名義人の名前 |
bank_name | string 銀行の名前 |
branch_name | string 銀行の支店名 |
country | string (ISO Alpha-2) 銀行口座の国 |
bank_address | string 銀行口座の住所 |
currency | string (ISO-4217) 銀行口座が扱う通貨 |
account_number | string 最後の4桁以外をマスクした口座番号 |
routing_number | string 銀行口座のルーティング番号 |
swift_code | string 銀行口座のSWIFTコード |
last_four | string 銀行口座の最後の4桁 |
status | stringnew , verified , unable_to_verify , errored のいずれか |
primary | boolean プライマリー銀行口座かどうかを指定 |
created_on | string (ISO-8601) 銀行口座が作成された日時 |