헥토파이낸셜 개발자센터

대기머니 출금 API

사용 취소로 인해 발생한 대기 상태의 머니를 출금하는 API입니다.

API 정보

POST/v1/money/wait/withdrawal
Content-Typeapplication/json
테스트https://tb-mps-api.hectofinancial.co.kr/v1/money/wait/withdrawal
운영https://mps-api.hectofinancial.co.kr/v1/money/wait/withdrawal

타임아웃 설정

출금 API 호출 시 타임아웃은 최소 25초 이상으로 설정해 주세요. (실제 은행 응답 최대 20초 소요)
NOTE

전액 출금만 가능

대기머니는 부분 출금이 불가능하며, 전액 출금만 가능합니다.

요청 파라미터

타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자
예: AN(10) = 영문+숫자, 최대 10byte
└custNoAN(20)영문+숫자, 최대 20byte*
선불 회원번호
*헥토파이낸셜에서 부여하는 고유 선불 회원 번호
└mTrdNoAN(50)영문+숫자, 최대 50byte*
상점 거래번호
*가맹점에서 발급한 거래번호 (한글 제외)
└divCdAN(2)영문+숫자, 최대 2byte*
구분코드
WW: 대기머니출금 (고정값)
└waitMnyBlcN(7)숫자, 최대 7byte*AES-256AES-256/ECB/PKCS5Padding + Base64
대기 머니 잔액
*AES-256/ECB/PKCS5Padding 암호화. 전액출금만 가능
└reqDtAN(8)영문+숫자, 최대 8byte
요청 일자
*yyyyMMdd. 입력 안 할 시 서버 일자로 자동 입력
└reqTmAN(6)영문+숫자, 최대 6byte
요청 시간
*HHmmss. 입력 안 할 시 서버 시간으로 자동 입력
└pinNoAN(6)영문+숫자, 최대 6byte*AES-256AES-256/ECB/PKCS5Padding + Base64
결제 비밀번호
*AES-256/ECB/PKCS5Padding 암호화 필요
└mResrvField1AN(255)영문+숫자, 최대 255byte
상점 여유필드 1
*평문으로 송수신되므로 개인정보와 같은 민감정보 포함되지 않도록 주의
└mResrvField2AN(255)영문+숫자, 최대 255byte
상점 여유필드 2
*평문으로 송수신되므로 개인정보와 같은 민감정보 포함되지 않도록 주의
└mResrvField3AN(255)영문+숫자, 최대 255byte
상점 여유필드 3
*평문으로 송수신되므로 개인정보와 같은 민감정보 포함되지 않도록 주의
└pktHashAN(200)영문+숫자, 최대 200byte*SHA-256(실시간 생성)
SHA-256 해시값
*선불회원번호 + 상점아이디 + 상점거래번호 + 대기머니잔액(평문) + 해시키

응답 파라미터

타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자
예: AN(10) = 영문+숫자, 최대 10byte
└rsltCdAN(4)영문+숫자, 최대 4byte*0000
응답코드
0000: 성공 그 외: 실패
└rsltMsgAN*성공
응답 메시지

rsltObj (응답 객체)

└custNoAN(20)영문+숫자, 최대 20byte*2400001605
선불 회원번호
└mtrdNoAN(50)영문+숫자, 최대 50byte*ORDER20240716
상점 거래번호
*한글 제외
└trdNoAN(50)영문+숫자, 최대 50byte*24071616270200002193
거래 승인번호
*헥토파이낸셜에서 부여하는 고유 거래번호
└trdAmtAN(7)영문+숫자, 최대 7byte*10000
거래금액
└waitMnyBlcAN(7)영문+숫자, 최대 7byte*0
거래 후 대기 머니 잔액
*전액 출금이므로 0
└trdDtAN(8)영문+숫자, 최대 8byte*20241212
거래 일자
*yyyyMMdd
└trdTmAN(6)영문+숫자, 최대 6byte*192035
거래 시간
*HHmmss
└pktHashAN(200)영문+숫자, 최대 200byte*
SHA-256 해시값
*선불회원번호 + 상점아이디 + 상점거래번호 + 거래승인번호 + 거래금액 + 해시키

요청 예시

{
  "custNo": "2400001605",
  "mTrdNo": "ORDER20240716",
  "divCd": "WW",
  "waitMnyBlc": "AES암호화된잔액",
  "reqDt": "20241212",
  "reqTm": "192035",
  "pinNo": "AES암호화된비밀번호",
  "pktHash": "해시값"
}

응답 예시

성공

{
  "rsltCd": "0000",
  "rsltMsg": "성공",
  "rsltObj": {
    "custNo": "2400001605",
    "mtrdNo": "ORDER20240716",
    "trdNo": "24071616270200002193",
    "trdAmt": "10000",
    "waitMnyBlc": "0",
    "trdDt": "20241212",
    "trdTm": "192035",
    "pktHash": "f395b6725a9a18f2563ce34f8bc76698051d27c05de5ba815f463f00429061c"
  }
}

실패

{
  "rsltCd": "2001",
  "rsltMsg": "대기 머니 잔액이 없습니다."
}
❓

더 궁금한 내용이 있나요?

FAQ
💬

기술지원이 필요한가요?