전체 연동 플로우
화이트라벨은 결제창(UI) 방식과 API 서버(Non-UI) 방식 두 가지로 연동할 수 있습니다.
연동 방식 선택
| 방식 | 설명 | 적합한 경우 |
|---|---|---|
| 결제창 (UI) | 헥토파이낸셜이 제공하는 표준 결제창을 호출 | 자체 결제 UI 개발 없이 빠르게 연동 |
| API 서버 (Non-UI) | 가맹점 서버에서 직접 결제 API 호출 | 가맹점이 자체 결제 UI를 직접 구성 |
방식 1: 결제창 (UI) 연동 플로우
고객
가맹점 프론트
가맹점 서버
헥토파이낸셜
11. 결제 요청
1. 결제 요청
22. 주문 정보 및 해시값 요청
2. 주문 정보 및 해시값 요청
33. 주문번호 + pktHash 반환
3. 주문번호 + pktHash 반환
44. 결제창 호출 (POST /whitelabel/main.do)
4. 결제창 호출 (POST /whitelabel/main.do)
55. 결제창 표시
5. 결제창 표시
66. 결제정보 입력
6. 결제정보 입력
77. 결제 결과 통보 (notiUrl)
7. 결제 결과 통보 (notiUrl)
88. OK 응답
8. OK 응답
99. 결제 완료 (nextUrl)
9. 결제 완료 (nextUrl)
결제창 서버 정보
| 구분 | 도메인 |
|---|---|
| 테스트베드 | tbwl.settlebank.co.kr |
| 상용 환경 | wl.settlebank.co.kr |
pktHash 생성 규칙 (결제창 호출)
결제창 호출 해시 생성pktHash
| 필드명 | 파라미터 |
|---|---|
| 상점 아이디 | mchtId |
| 결제수단 | method |
| 상점 주문번호 | mchtTrdNo |
| 요청 일자 | trdDt |
| 요청 시간 | trdTm |
| 거래금액 (평문) | trdAmt |
| 해쉬키 | hashKey |
SHA256(mchtId + method + mchtTrdNo + trdDt + trdTm + trdAmt(평문) + hashKey)결제창 API 문서
방식 2: API 서버 (Non-UI) 연동 플로우
고객
가맹점 프론트
가맹점 서버
헥토파이낸셜
11. 결제 요청
1. 결제 요청
22. 결제 요청 전달
2. 결제 요청 전달
33. 결제 API 호출 (POST /whitelabel/v1/pay_confirm.do)
3. 결제 API 호출 (POST /whitelabel/v1/pay_confirm.do)
44. 결제 결과 응답
4. 결제 결과 응답
55. 결제 완료 처리
5. 결제 완료 처리
66. 결과 표시
6. 결과 표시
API 서버 정보
| 구분 | 도메인 |
|---|---|
| 테스트베드 | tbapi.settlebank.co.kr |
| 상용 환경 | api.settlebank.co.kr |
pktHash 생성 규칙 (결제/취소 API 공통)
결제/취소 API 해시 생성pktHash
| 필드명 | 파라미터 |
|---|---|
| 요청 일자 | trdDt |
| 요청 시간 | trdTm |
| 상점 아이디 | mchtId |
| 상점 주문번호 | mchtTrdNo |
| 거래금액 (평문) | trdAmt |
| 해쉬키 | hashKey |
SHA256(trdDt + trdTm + mchtId + mchtTrdNo + trdAmt(평문) + hashKey)
공통 응답 코드
| 필드 | 성공 | 실패 |
|---|---|---|
outStatCd | 0021 | 0031 |
outRsltCd | 0000 | 오류 코드 |
