Sign in

v1

latestOpenAPI 3.0.12026-07-24510443.1 KB
출금(Withdrawal)

원화 출금 요청

원화(KRW) 출금을 요청합니다.

post/withdraws/krw

Request body

amountstring required

출금하고자 하는 원화 금액. 숫자 형식의 String으로 입력합니다.

two_factor_type'kakao' | 'naver' | 'hana' required

원화 입출금 시 사용할 2차 인증 수단. 사용 가능한 값은 다음과 같습니다.

  • kakao: 카카오 인증
  • naver: 네이버 인증
  • hana: 하나인증서 인증

Example request

{
  "amount": "100000000",
  "two_factor_type": "kakao"
}

Response

Object of KRW withdrawal

typestring required

입출금 종류

uuidstring required

출금의 유일 식별자

currencystring required

출금하고자 하는 통화 코드.

txidstring nullable required

트랜잭션 ID

state'WAITING' | 'PROCESSING' | 'DONE' | 'FAILED' | 'CANCELLED' | 'REJECTED' required

출금 처리 상태

  • WAITING: 대기 중
  • PROCESSING: 처리 중
  • DONE: 완료
  • FAILED: 실패
  • CANCELLED: 취소됨
  • REJECTED: 거절됨
created_atstring required

출금 생성 시간

done_atstring nullable

출금 완료 시간. 출금이 완료되지 않은 경우 null로 반환됩니다

amountstring required

출금 원화 금액

feestring required

출금 수수료

transaction_type'default' | 'internal' required

출금 유형. 사용 가능한 값은 다음과 같습니다.

  • default: 일반출금
  • internal: 바로출금
is_cancelableboolean required

출금 취소 가능 여부

Example response

{
  "type": "withdraw",
  "uuid": "9f432943-54e0-40b7-825f-b6fec8b42b79",
  "currency": "KRW",
  "state": "WAITING",
  "created_at": "2024-01-01T00:00:00",
  "done_at": "2024-01-01T00:00:00",
  "transaction_type": "default"
}