API

출금 신청

작성일 2026.03.13 | 수정일 2026.03.13

POST/cash/v1/withdraw

등록된 은행 계좌로 잔액 출금을 신청합니다.
출금 수수료는 신청 금액의 5%에 500원을 더한 금액입니다. 잔액에서 총액(신청 금액)이 즉시 차감되며, 출금은 관리자 승인 후 처리됩니다.

Body Params

Name	Type	Required	Description
amount	number	*	출금 신청 금액 (원). 최소 10,000원 ~ 최대 10,000,000원. 이 금액에서 수수료(5% + 500원)가 차감된 금액이 실제 출금됩니다.

Response

Name	Type	Required	Description
withdrawId	string	*	생성된 출금 건 고유 ID
accountId	string	*	계정 고유 ID
accountNumber	string	*	출금 계좌번호 (암호화된 값)
bankCode	string	*	은행 코드
holderName	string	*	예금주명
amount	number	*	실 출금 금액 (수수료 차감 후)
fee	number	*	출금 수수료
totalAmount	number	*	총 신청 금액
status	string	*	출금 상태. 신청 직후에는 'PENDING'.
dateCreated	string	*	신청 일시 (ISO 8601)

Structure

Request

{
  "amount": 100000
}

Response

{
  "withdrawId": "17198765432101234567890",
  "accountId": "12345678901234",
  "accountNumber": "ENCRYPTED_VALUE",
  "bankCode": "004",
  "holderName": "홍길동",
  "amount": 94500,
  "fee": 5500,
  "totalAmount": 100000,
  "status": "PENDING",
  "dateCreated": "2024-07-01T12:00:00.000Z"
}