전체 연동 플로우
안심선불은 **UI 화면(회원 등록/관리)**과 **API 서버(잔액 사용/충전/조회)**를 함께 사용하는 서비스입니다.
전체 흐름
고객
가맹점
헥토파이낸셜
11. 서비스 이용 요청
1. 서비스 이용 요청
22. 회원 등록 화면 호출 (GET /identity)
2. 회원 등록 화면 호출 (GET /identity)
33. 회원 등록 화면 표시
3. 회원 등록 화면 표시
44. 본인인증 및 정보 입력
4. 본인인증 및 정보 입력
55. 등록 결과 반환 (returnUrl)
5. 등록 결과 반환 (returnUrl)
66. 잔액 사용/충전/조회 API 호출
6. 잔액 사용/충전/조회 API 호출
77. 처리 결과 응답
7. 처리 결과 응답
NOTE
최초 1회 회원 등록
회원 등록(2~5단계)은 최초 1회만 수행합니다. 등록 완료 후에는 API를 통해 잔액 사용, 충전, 조회 등의 기능을 바로 사용할 수 있습니다.
1단계: 회원 등록 화면 (UI)
가맹점에서 헥토파이낸셜이 제공하는 회원 등록 화면을 호출합니다.
| 구분 | URL |
|---|---|
| 테스트계 | https://tb-mps.hectofinancial.co.kr/identity |
| 운영계 | https://mps.hectofinancial.co.kr/identity |
| HTTP Method | GET |
필수 파라미터
| 파라미터 | 설명 |
|---|---|
mId | 상점 아이디 |
mCustId | 선불 회원 아이디 |
ciEnc | 고객 CI (AES-256/ECB/PKCS5Padding, Base64 인코딩) |
returnUrl | 등록 완료 후 반환될 URL |
2단계: 잔액 사용 / 충전 / 조회 API
회원 등록 후 가맹점 서버에서 API를 직접 호출합니다.
| 구분 | 도메인 |
|---|---|
| 테스트베드 | tb-mps-api.hectofinancial.co.kr |
| 상용 환경 | mps-api.hectofinancial.co.kr |
| HTTP Method | POST |
| Content-Type | application/json;charset=UTF-8 |
pktHash 생성 규칙
API 공통 해시 생성pktHash
| 필드명 | 파라미터 |
|---|---|
| 선불 회원번호 | custNo |
| 상점 아이디 | mchtId |
| 상점 거래번호 | mTrdNo |
| 거래금액 (평문) | trdAmt |
| 해시키 | hashKey |
SHA256(custNo + mchtId + mTrdNo + trdAmt(평문) + hashKey)NOTE
취소 API 해시 조합
사용취소/충전취소 API는 trdAmt 대신 orgTrdNo + orgTrdDt를 사용합니다: custNo + mchtId + mTrdNo + orgTrdNo + orgTrdDt + hashKey
주요 API
| 기능 | URI |
|---|---|
| 잔액 조회 | /v1/wallet/balance |
| 사용 | /v1/wallet/use |
| 사용 취소 | /v1/wallet/use/cancel |
| 지급(충전) | /v1/approval/charge |
| 지급(충전) 취소 | /v1/approval/charge/cancel |
| 출금 | /v1/money/withdrawal |
| 거래 내역 조회 | /v1/trade/list |
