API

은행 계좌 등록

작성일 2026.03.13 | 수정일 2026.03.13

POST/cash/v1/bank/accounts

수익금 및 잔액 출금을 위한 은행 계좌를 등록합니다. 이미 등록된 계좌가 있는 경우 에러가 발생합니다.

Body Params

Name	Type	Required	Description
accountNumber	number	*	등록할 계좌번호
bankCode	string	*	은행 코드 (최대 10자)
holderName	string	*	예금주명 (최대 20자)
authenticationCode	string		계좌 인증 코드 (4자리)
transactionId	string		계좌 인증 트랜잭션 ID (최대 40자)

Name	Type	Required	Description
accountNumber	string	*	등록된 계좌번호
bankCode	string	*	은행 코드
holderName	string	*	예금주명
success	boolean	*	등록 성공 여부. 항상 true.

Request

{
  "accountNumber": 1234567890123,
  "bankCode": "004",
  "holderName": "홍길동"
}

Response

{
  "accountNumber": "1234567890123",
  "bankCode": "004",
  "holderName": "홍길동",
  "success": true
}