사용 취소 API
선불금 사용(결제)을 취소하는 API입니다.
API 정보
POST/v1/wallet/use/cancel
Content-Type
application/json테스트
https://tb-mps-api.hectofinancial.co.kr/v1/wallet/use/cancel운영
https://mps-api.hectofinancial.co.kr/v1/wallet/use/cancel요청 파라미터
타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자예: AN(10) = 영문+숫자, 최대 10byte
└custNoAN(20)영문+숫자, 최대 20byte*선불 회원번호
선불 회원번호
*헥토파이낸셜에서 부여하는 고유 선불 회원 번호
└mTrdNoAN(50)영문+숫자, 최대 50byte*상점 거래번호
상점 거래번호
*가맹점에서 발급한 거래번호 (한글 제외)
└orgTrdNoAN(50)영문+숫자, 최대 50byte*원거래 승인번호
원거래 승인번호
*취소하려는 거래의 헥토파이낸셜 거래 승인번호
└orgTrdDtAN(8)영문+숫자, 최대 8byte*원거래 일자
원거래 일자
*취소하려는 거래의 일자. yyyyMMdd
└mnyBlcN(7)숫자, 최대 7byte*
AES-256AES-256/ECB/PKCS5Padding + Base64머니 잔액머니 잔액
*AES-256/ECB/PKCS5Padding 암호화 필요
└pntBlcN(7)숫자, 최대 7byte*
AES-256AES-256/ECB/PKCS5Padding + Base64포인트 잔액포인트 잔액
*AES-256/ECB/PKCS5Padding 암호화 필요
└cnclMnyAmtN(7)숫자, 최대 7byte*
AES-256AES-256/ECB/PKCS5Padding + Base64취소 머니 금액취소 머니 금액
*취소하려는 머니 금액. AES-256/ECB/PKCS5Padding 암호화 필요
└cnclPntAmtN(7)숫자, 최대 7byte*
AES-256AES-256/ECB/PKCS5Padding + Base64취소 포인트 금액취소 포인트 금액
*취소하려는 포인트 금액. AES-256/ECB/PKCS5Padding 암호화 필요
└trdSumryAN(50)영문+숫자, 최대 50byte거래 적요
거래 적요
*사용 취소 사유
└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(255)영문+숫자, 최대 255byte*응답 메시지
성공응답 메시지
rsltObj (응답 객체)
└custNoAN(20)영문+숫자, 최대 20byte*선불 회원번호
2400001605선불 회원번호
└mtrdNoAN(50)영문+숫자, 최대 50byte*상점 거래번호
ORDER20240716상점 거래번호
*한글 제외
└trdNoAN(50)영문+숫자, 최대 50byte*거래 승인번호
24071616270200002193거래 승인번호
*헥토파이낸셜에서 부여하는 고유 거래번호
└mnyBlcN(7)숫자, 최대 7byte*머니 잔액
11000머니 잔액
*취소 후 머니 잔액
└pntBlcN(7)숫자, 최대 7byte*포인트 잔액
1000포인트 잔액
*취소 후 포인트 잔액
└waitMnyBlcN(7)숫자, 최대 7byte*대기 머니 잔액
1000대기 머니 잔액
*사용 취소로 인해 대기 머니 발생한 경우
└trdDtAN(8)영문+숫자, 최대 8byte*거래 일자
20240718거래 일자
*취소 거래 일자. yyyyMMdd
└trdTmAN(6)영문+숫자, 최대 6byte*거래 시각
190801거래 시각
*취소 거래 시각. HHmmss
└expPntAmtN(7)숫자, 최대 7byte*만료 포인트 금액
1000만료 포인트 금액
*사용취소 후, 취소하려는 포인트의 소멸일자가 도래하여 포인트가 소멸된 경우
└expTrdDtAN(8)영문+숫자, 최대 8byte만료 일자
20240718만료 일자
*포인트 만료 처리 일자. yyyyMMdd
└expTrdTmAN(6)영문+숫자, 최대 6byte만료 시각
190801만료 시각
*포인트 만료 처리 시각. HHmmss
└pktHashAN(200)영문+숫자, 최대 200byte*SHA-256 해시값
SHA-256 해시값
*선불회원번호 + 상점아이디 + 상점거래번호 + 거래승인번호 + 해시키
요청 예시
{
"custNo": "2400001605",
"mTrdNo": "ORDER20240716",
"orgTrdNo": "24071516270200002193",
"orgTrdDt": "20240715",
"mnyBlc": "AES암호화된잔액",
"pntBlc": "AES암호화된잔액",
"cnclMnyAmt": "AES암호화된금액",
"cnclPntAmt": "AES암호화된금액",
"trdSumry": "단순 변심",
"pktHash": "해시값"
}
응답 예시
성공
{
"rsltCd": "0000",
"rsltMsg": "성공",
"rsltObj": {
"custNo": "2400001605",
"mtrdNo": "ORDER20240716",
"trdNo": "24071616270200002193",
"mnyBlc": "11000",
"pntBlc": "1000",
"waitMnyBlc": "0",
"trdDt": "20240718",
"trdTm": "190801",
"expPntAmt": "0",
"pktHash": "f395b6725a9a18f2563ce34f8bc76698051d27c05de5ba815f463f00429061c"
}
}
실패 (취소 불가)
{
"rsltCd": "T-011",
"rsltMsg": "기취소된 거래입니다."
}
주의사항
- 부분취소가 가능합니다.
- 취소금액이 원거래 금액을 초과할 수 없습니다.
- 이미 전액 취소된 거래는 재취소할 수 없습니다.
- 취소 시 대기머니가 발생할 수 있습니다. (
waitMnyBlc확인 필요) - 포인트 취소 시 포인트 만료일이 도래하면 포인트가 소멸될 수 있습니다.
