머니 출금 API
회원의 머니를 등록된 계좌로 출금하는 API입니다.
API 정보
POST/v1/money/withdrawal
Content-Type
application/json테스트
https://tb-mps-api.hectofinancial.co.kr/v1/money/withdrawal운영
https://mps-api.hectofinancial.co.kr/v1/money/withdrawal타임아웃 설정
출금 API 호출 시 타임아웃은 최소 25초 이상으로 설정해 주세요. (실제 은행 응답 최대 20초 소요)
출금 유형
| 유형 | API | 설명 |
|---|---|---|
| 머니 출금 | /v1/money/withdrawal | 일반 머니 출금 |
| 대기머니 출금 | /v1/money/wait/withdrawal | 대기 상태 머니 출금 (전액출금만 가능) |
| 출금 가능 조회 | /v1/wallet/balance/withdrawal | 출금 가능 금액 및 횟수 조회 |
NOTE
포인트 출금 불가
포인트는 출금이 불가능합니다. 결제(사용)에만 사용할 수 있습니다.
요청 파라미터
타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자예: AN(10) = 영문+숫자, 최대 10byte
└custNoAN(20)영문+숫자, 최대 20byte*선불 회원번호
선불 회원번호
*헥토파이낸셜에서 부여하는 고유 선불 회원 번호
└mTrdNoAN(50)영문+숫자, 최대 50byte*상점 거래번호
상점 거래번호
*가맹점에서 발급한 거래번호 (한글 제외)
└divCdAN(2)영문+숫자, 최대 2byte*구분코드
구분코드
MW: 머니출금 (고정값)└trdAmtN(7)숫자, 최대 7byte*
AES-256AES-256/ECB/PKCS5Padding + Base64출금 요청 금액출금 요청 금액
*AES-256/ECB/PKCS5Padding 암호화 후 Base64 인코딩
└mnyBlcN(7)숫자, 최대 7byte*
AES-256AES-256/ECB/PKCS5Padding + Base64머니 잔액머니 잔액
*AES-256/ECB/PKCS5Padding 암호화 필요
└custBdnFeeAmtN(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
상점 여유필드 1
*평문으로 송수신되므로 개인정보와 같은 민감정보 포함되지 않도록 주의
└mResrvField2AN(255)영문+숫자, 최대 255byte상점 여유필드 2
상점 여유필드 2
*평문으로 송수신되므로 개인정보와 같은 민감정보 포함되지 않도록 주의
└mResrvField3AN(255)영문+숫자, 최대 255byte상점 여유필드 3
상점 여유필드 3
*평문으로 송수신되므로 개인정보와 같은 민감정보 포함되지 않도록 주의
└pktHashAN(200)영문+숫자, 최대 200byte*
SHA-256SHA-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거래 승인번호
*헥토파이낸셜에서 부여하는 고유 거래번호
└trdAmtN(7)숫자, 최대 7byte*거래금액
10000거래금액
└custBdnFeeAmtN(7)숫자, 최대 7byte*고객 부담 수수료 금액
100고객 부담 수수료 금액
└mnyBlcN(7)숫자, 최대 7byte*거래 후 머니 잔액
10000거래 후 머니 잔액
└trdDtAN(8)영문+숫자, 최대 8byte*거래 일자
20241212거래 일자
*yyyyMMdd
└trdTmAN(6)영문+숫자, 최대 6byte*거래 시간
192035거래 시간
*HHmmss
└pktHashAN(200)영문+숫자, 최대 200byte*SHA-256 해시값
SHA-256 해시값
*선불회원번호 + 상점아이디 + 상점거래번호 + 거래승인번호 + 거래금액 + 해시키
요청 예시
{
"custNo": "2400001605",
"mTrdNo": "ORDER20240716",
"divCd": "MW",
"trdAmt": "AES암호화된금액",
"mnyBlc": "AES암호화된잔액",
"reqDt": "20241212",
"reqTm": "192035",
"pinNo": "AES암호화된비밀번호",
"pktHash": "해시값"
}
응답 예시
성공
{
"rsltCd": "0000",
"rsltMsg": "성공",
"rsltObj": {
"custNo": "2400001605",
"mtrdNo": "ORDER20240716",
"trdNo": "24071616270200002193",
"trdAmt": "10000",
"custBdnFeeAmt": "100",
"mnyBlc": "10000",
"trdDt": "20241212",
"trdTm": "192035",
"pktHash": "f395b6725a9a18f2563ce34f8bc76698051d27c05de5ba815f463f00429061c"
}
}
실패 (잔액 부족)
{
"rsltCd": "2001",
"rsltMsg": "출금 가능한 잔액이 부족합니다."
}
실패 (비밀번호 오류)
{
"rsltCd": "3001",
"rsltMsg": "비밀번호가 일치하지 않습니다. (1/5회)"
}
주의사항
결제 비밀번호 오류 횟수 제한
결제 비밀번호를 5회 이상 틀리면 계정이 잠금 처리됩니다.
- 등록된 출금 계좌로만 출금됩니다.
- 출금 계좌 변경은 내정보 화면에서 가능합니다.
- 출금 한도가 적용될 수 있습니다.
- 포인트는 출금이 불가능합니다.
