API

출금 요청 상태 조회

작성일 2026.03.13 | 수정일 2026.03.13

GET/cash/v1/withdraw

Query

withdrawId— 특정 출금 건의 고유 ID로 조회. 숫자만 허용.

status— 출금 상태 필터. PENDING, COMPLETE, FAILED 중 선택.

startKey— 이전 응답의 nextKey를 전달하여 다음 페이지 조회

limit— 조회 건수 (기본값: 20, 최소: 1)

startDate— 조회 시작 날짜 (ISO 8601)

endDate— 조회 종료 날짜 (ISO 8601)

출금 신청 내역과 현재 처리 상태를 조회합니다. 계좌번호는 마지막 4자리를 제외하고 마스킹(*) 처리되어 반환됩니다.

Response

Name	Type	Required	Description
data	array	*	출금 내역 목록
withdrawId	string	*	출금 건 고유 ID
accountId	string	*	계정 고유 ID
bankCode	string\|null	*	은행 코드
accountNumber	string	*	계좌번호 (마지막 4자리 제외 마스킹 처리)
holderName	string\|null	*	예금주명
amount	number	*	실 출금 금액 (수수료 차감 후)
fee	number	*	출금 수수료 (신청 금액의 5% + 500원)
totalAmount	number	*	총 신청 금액 (amount + fee)
status	string	*	출금 처리 상태. PENDING(대기), COMPLETE(완료), FAILED(실패).
memo	string\|null		메모
dateCreated	string	*	신청 일시 (ISO 8601)
dateUpdated	string	*	최종 수정 일시 (ISO 8601)
nextKey	string\|null	*	다음 페이지 조회를 위한 키. null이면 더 이상 데이터가 없습니다.

Structure

Response

{
  "data": [
    {
      "withdrawId": "17198765432101234567890",
      "accountId": "12345678901234",
      "bankCode": "004",
      "accountNumber": "*********0123",
      "holderName": "홍길동",
      "amount": 9000,
      "fee": 1000,
      "totalAmount": 10000,
      "status": "PENDING",
      "memo": null,
      "dateCreated": "2024-07-01T12:00:00.000Z",
      "dateUpdated": "2024-07-01T12:00:00.000Z"
    }
  ],
  "nextKey": null
}