PC 에스크로 결제
KG이니시스 결제창을 호출하여 다양한 지불수단을 제공하는 매매보호 결제 서비스
Quick Guide
샘플 다운로드
개발 언어에 맞는 샘플을
다운로드 받아 주세요.
리턴 URL 수정
결제요청페이지 도메인과 일치하도록
리턴 URL을
수정해 주세요.
테스트 실행 및 결과확인
결제 진행과정과
응답결과를 확인해 주세요.
실제 연동진행
가맹점 실서버 환경에 맞게
연동을 진행해주세요.
연동 준비하기
PC(웹표준)결제 연동 전, 체크해야할 사항을 안내드립니다.
MID상점아이디
계약 완료 여부, 사용 가능 지불 수단 등은 계약담당자 문의Signkey대칭키
가맹점관리자 ▶ 상점정보 ▶ 계약정보 ▶ 부가정보 ▶ 웹결제 signkey 생성조회방화벽정보
항목 | 스테이징환경 | 운영환경 |
---|---|---|
URL | stgstdpay.inicis.com | fcstdpay.inicis.com ksstdpay.inicis.com |
IP | 118.129.210.47 | 118.129.210.86 183.109.71.30 |
PORT | 443 | |
연결방향 | OUTBOUND |
STEP 1결제요청
결제요청정보
- 결제요청 JS : https://stdpay.inicis.com/stdjs/INIStdPay.js
- HTTP Method : POST
- Accept-charset : UTF-8
- 필수파라미터
- 선택파라미터
- 추가옵션 (acceptmethod)
version* | 전문 버전 ["1.0" 고정] |
20 byte
|
---|---|---|
gopaymethod* | 요청지불수단 빈값으로 세팅 시, 전체 결제수단 표시 |
지불수단
N/A
|
mid* | 상점아이디 |
10 byte
|
oid* | 주문번호 반드시 Unique 값으로 생성 (거래추적 시 사용됨) |
40 byte
|
price* | 결제금액 숫자만 허용, 1달러는 100으로 시작 |
64 byte
|
timestamp* | 타임스템프 [TimeInMillis(Long형)] |
20 byte
|
use_chkfake* | PC결제 보안강화 사용 ["Y" 고정] |
1 byte
|
signature* | SHA256 Hash값 대상: oid, price, timestamp |
HASH
64 byte
|
verification* | SHA256 Hash값 대상: oid, price, signKey, timestamp |
HASH
64 byte
|
mKey* | SHA256 Hash값 대상: mid 와 매칭되는 signKey |
HASH
64 byte
|
currency* | 통화구분 ["WON":한화,"USD":달러] USD는 카드 결제만 가능 |
3 byte
|
goodname* | 상품명 40Byte 초과 요청시 37Byte + ...으로 자동 변환 |
40 byte
|
buyername* | 구매자명 30Byte 초과 요청시 30Byte로 자동 변환 |
30 byte
|
buyertel* | 구매자 휴대폰번호 숫자와 "-" 만 허용 |
20 byte
|
buyeremail* | 구매자 이메일주소 "@", "." 외 특수문자 입력불가 |
60 byte
|
returnUrl* | 결과수신 URL |
N/A
|
closeUrl* | 결제창 닫기 URL |
N/A
|
acceptmethod* | "centerCd(Y)" IDC센터코드 수신 사용옵션 세팅 필수 ex) acceptmethod = centerCd(Y) 여러옵션 추가 세팅 시 ":"(콜론) 구분자 사용 |
N/A
|
quotabase | 할부개월수 노출옵션 [할부개월:할부개월] 금액이 할부조건일 경우 동작 ex) 세팅 예시 일시불 세팅 시, value="00" 2~6개월 세팅 시, value="02:03:04:05:06" |
N/A
|
---|---|---|
nointerest | 상점부담 무이자할부 옵션 [카드코드-개월:개월,카드코드-개월:개월] "상점부담무이자" 계약 가맹점만 사용 |
N/A
|
tax | 부가세 "부가세 업체정함" 계약가맹점만 설정필요. |
64 byte
|
taxfree | 비과세 (면세상품 금액) "부가세 업체정함" 계약가맹점만 설정필요 |
64 byte
|
charset | 결과 수신 인코딩 [UTF-8,EUC-KR] Default: UTF-8 |
6 byte
|
offerPeriod | 제공기간 [Y2:년단위결제, M2:월단위결제, YYYYMMDD-YYYYMMDD:시작일-종료일] 결제 고객에게 노출용도 |
N/A
|
payViewType | 결제창 호출 방법 [overlay,popup] Default: overlay |
7 byte
|
languageView | 결제창 언어 설정 ["ko":국문, "en":영문, "cn":중문] Default: "ko":국문 |
2 byte
|
logo_url | 메인로고 삽입 [size: 89*18] 이미지 전체 도메인주소 세팅 |
N/A
|
logo_2nd | 서브로고 삽입 [size: 64*13] 이미지 전체 도메인주소 세팅 |
N/A
|
popupUrl | 팝업처리 URL payViewType=popup 으로 진행 시 세팅 필요 |
N/A
|
parentemail | 보호자 이메일주소 14세 미만 필수, "@", "." 외 특수문자 입력불가 |
60 byte
|
ini_ssgpay_mdn | SSGPAY 결제요청 시 PUSH전송 휴대폰번호 숫자만 허용 |
20 byte
|
merchantData | 가맹점 임의 데이터 (인증결과수신 구간에서 전달) 한글 입력불가, 한글입력은 urlencode 필수 |
2000 byte
|
acceptmethod | 지불수단별 추가옵션 상단 [추가옵션] 탭 참고 |
N/A
|
※ acceptmethod 세팅예시 옵션 구분자 ":"(콜론) |
|||
---|---|---|---|
acceptmethod | useescrow* | 신에스크로 사용옵션 신에스크로 계약가맹점만 사용 |
에스크로
|
acceptmethod | centerCd(Y) * | IDC센터코드 수신 사용옵션 |
공통
|
popreturn | 부모페이지 유지옵션 (결제창 종료 후 returnUrl 호출 시, 강제로 결제요청페이지 내 프레임을 지정하여 호출) |
공통
|
|
SKIN(색상코드) | 결제창 배경색상 [Default: #C1272C] |
공통
|
|
acceptmethod | below1000 | 신용카드 결제 시 1000원 이하금액 결제가능 옵션 |
신용카드
|
ini_onlycardcode(카드코드:카드코드) | 결제 카드사 선택 노출옵션 Default: 결제가능한 모든 카드사 표시 |
신용카드
|
|
cardpoint | 카드포인트 사용유무 선택창 표시옵션 별도계약시 사용가능 |
신용카드
|
|
ocb | 카드 메인화면에 OCB 적립을 위한 카드번호 창 표시옵션 별도계약시 사용가능 |
신용카드
|
|
slimquota(카드코드-개월:개월) | 부분무이자 설정 별도계약시 사용가능 |
신용카드
|
|
mallpoint(카드코드:카드코드) | 몰포인트 별도계약시 사용가능 |
신용카드
|
|
paypopup | 안심클릭계열 신용카드 POPUP 형태 표시옵션 |
신용카드
|
|
hidebar | 프로그래스바 미노출 옵션 |
신용카드
|
|
acceptmethod | no_receipt | 현금영수증 UI 미노출 옵션 Default: 현금영수증 UI 노출 |
계좌이체
|
acceptmethod | va_receipt | 현금영수증 UI 노출 옵션 Default: 현금영수증 UI 미노출 |
가상계좌
|
vbank(YYYYMMDD) | 입금기한 및 입금시간 설정옵션 시, 분까지 지정 시 YYYYMMDDhhmm 로 세팅 |
가상계좌
|
|
acceptmethod | HPP(1) | 휴대폰결제 상품유형 ["1":컨텐츠, "2":실물] MID 계약사항에 맞게 세팅 |
휴대폰
|
STEP 2인증결과
resultCode | 결과코드 "0000":성공, 이외 실패 |
10 byte
|
---|---|---|
resultMsg | 결과메시지 |
100 byte
|
mid | 상점아이디 |
10 byte
|
orderNumber | 주문번호 결제요청 시 세팅한 주문번호 |
40 byte
|
authToken | 승인요청 검증 토큰 |
N/A
|
idc_name | IDC센터코드 [fc, ks, stg] 승인요청 시 authUrl 과 비교검증 필요 |
CODE
N/A
|
authUrl | 승인요청 Url 해당 URL로 HTTPS API Request 승인요청 - POST 이니시스 제공 승인API 가 맞는지 확인 필요 (IDC센터코드와 비교 검증 필요) |
N/A
|
netCancelUrl | 망취소요청 Url 승인요청 후 승인결과 수신 실패 / DB저장 실패 시 |
64 byte
|
charset | 인증결과 인코딩 [Default: UTF-8] |
6 byte
|
merchantData | 가맹점 임의 데이터 |
2000 byte
|
STEP 3승인요청
승인요청 정보
- 승인요청 URL : STEP2 인증결과 수신 시 응답된 authUrl
이니시스 제공 승인API 가 맞는지 확인 필요 (IDC센터코드와 비교 검증 필요) - Content-type: application/x-www-form-urlencoded
- HTTP Method : POST
- 통신방식 : http-Client 통신
mid* | 상점아이디 |
10 byte
|
---|---|---|
authToken* | 승인요청 검증 토큰 |
N/A
|
timestamp* | 타임스템프 [TimeInMillis(Long형)] |
20 byte
|
signature* | SHA256 Hash값 대상: authToken, timestamp |
HASH
60 byte
|
verification* | SHA256 Hash값 대상: authToken, signKey, timestamp |
HASH
60 byte
|
charset* | 인증결과 인코딩 [Default: UTF-8] |
6 byte
|
format* | 리턴형식 [XML, JSON, NVP] |
리턴샘플
5 byte
|
price | 인증가격 옵션필드 (제외가능) |
64 byte
|
resultLanguage | 승인 응답 시, resultMsg 언어 설정 [ "ENG":영문, "CHI":중문, Default:국문 ] 옵션필드 (제외가능) |
N/A
|
STEP 4승인결과
※ 유의사항
해당 응답파라미터는 모든 프로세스 종료 후 최종적으로 전달되는 결과값 입니다.
- 응답파라미터는 추후 요건에 의해 추가될 수 있습니다.
- 실패 응답 시, 일부 파라미터 응답이 null 일 수 있습니다.
- 공통
- 신용카드
- 계좌이체/가상계좌
resultCode | 결과코드 "0000":성공, 이외 실패 (실패코드 6byte) |
6 byte
|
---|---|---|
resultMsg | 결과메세지 |
100 byte
|
tid | 거래번호 |
40 byte
|
mid | 상점아이디 |
10 byte
|
MOID | 주문번호 결제 요청시 oid 필드에 설정된 값 |
40 byte
|
TotPrice | 결제금액 |
20 byte
|
goodName | 상품명 |
40 byte
|
payMethod | 지불수단 |
지불수단
N/A
|
applDate | 승인일자 [YYYYMMDD] |
8 byte
|
applTime | 승인시간 [hh24miss] |
6 byte
|
EventCode | 이벤트 코드, 카드 할부 및 행사 적용 코드 |
2 byte
|
buyerName | 구매자명 |
30 byte
|
buyerTel | 구매자 휴대폰번호 |
20 byte
|
buyerEmail | 구매자 이메일주소 |
60 byte
|
custEmail | 최종 이메일주소 |
60 byte
|
applNum | 승인번호 |
신용카드
8 byte
|
---|---|---|
CARD_Num | 신용카드번호 |
신용카드
16 byte
|
CARD_Interest | 상점부담 무이자 할부여부 ["1":상점부담 무이자] |
신용카드
1 byte
|
CARD_Quota | 카드 할부기간 |
신용카드
2 byte
|
CARD_Code | 카드사 코드 |
신용카드
2 byte
|
CARD_CorpFlag | 카드구분 ["0":개인카드, "1":법인카드, "9":구분불가] |
신용카드
1 byte
|
CARD_CheckFlag | 카드종류 ["0":신용카드, "1":체크카드, "2":기프트카드] |
신용카드
1 byte
|
CARD_PRTC_CODE | 부분취소 가능여부 ["1":가능 , "0":불가능] |
신용카드
1 byte
|
CARD_BankCode | 카드발급사(은행) 코드 |
신용카드
2 byte
|
CARD_SrcCode | 간편(앱)결제구분 |
신용카드
1 byte
|
CARD_Point | 카드포인트 사용여부 ["":카드 포인트 사용안함, "1":카드 포인트 사용] |
신용카드
1 byte
|
CARD_UsePoint | 포인트 사용금액 |
신용카드
12 byte
|
CARD_CouponPrice | 실제 카드승인 금액 |
신용카드
N/A
|
CARD_CouponDiscount | 쿠폰(즉시할인) 금액 |
신용카드
N/A
|
NAVERPOINT_UseFreePoint | 네이버포인트 무상포인트 |
신용카드
12 byte
|
NAVERPOINT_CSHRApplYN | 네이버포인트 현금영수증 발행여부 ["Y":발행, "N":미발행] |
신용카드
1 byte
|
NAVERPOINT_CSHRApplAmt | 네이버포인트 현금영수증 발행 금액 |
신용카드
12 byte
|
PCO_OrderNo | 페이코 주문번호 |
신용카드
N/A
|
currency | 통화코드 |
신용카드
3 byte
|
OrgPrice | 달러 환전금액 해외카드 + 달러(USD) 결제 일 경우 환전금액 |
신용카드
N/A
|
ACCT_BankCode | 은행코드 |
계좌이체
2 byte
|
---|---|---|
CSHR_ResultCode | 현금영수증 발행 정상여부 ["220000": 정상] |
계좌이체
6 byte
|
CSHR_ApplNum | 현금영수증 발행 승인번호 |
계좌이체
9 byte
|
CSHR_Type | 현금영수증구분 ["0":소득공제, "1":지출증빙] |
계좌이체
1 byte
|
ACCT_Name | 계좌주명 |
계좌이체
30 byte
|
VACT_Num | 가상계좌번호 |
입금통보
가상계좌
14 byte
|
VACT_BankCode | 입금은행코드 |
가상계좌
2 byte
|
vactBankName | 입금은행명 |
가상계좌
N/A
|
VACT_Name | 예금주명 |
가상계좌
20 byte
|
VACT_InputName | 송금자명 결제창 내 입력한 '송금자명' / Default: 구매자명값 |
가상계좌
N/A
|
VACT_Date | 입금기한일자 [YYYYMMDD] |
가상계좌
8 byte
|
VACT_Time | 입금기한시각 [hhmmss] |
가상계좌
6 byte
|
(예외) 망취소처리 요청
망취소요청 정보
가맹점에서 승인결과 전문 처리 중 예외발생 시 망취소 요청할 수 있습니다.
※ 망취소 요청가능시간 : 인증결과 응답 후 10분 이내
※ 망취소를 일반 결제취소 용도로 사용하지 마십시오.
- 망취소요청 URL : STEP2 인증결과 수신 시 응답된 netCancelUrl
- Content-type: application/x-www-form-urlencoded
- HTTP Method : POST
- 통신방식 : http-Client 통신
- 망취소 요청
- 망취소 응답
mid* | 상점아이디 |
10 byte
|
---|---|---|
authToken* | 승인요청 검증 토큰 |
N/A
|
timestamp* | 타임스템프 [TimeInMillis(Long형)] |
20 byte
|
signature* | SHA256 Hash값 대상: authToken, timestamp |
HASH
60 byte
|
verification* | SHA256 Hash값 대상: authToken, signKey, timestamp |
HASH
60 byte
|
charset* | 인증결과 인코딩 [Default: UTF-8] |
6 byte
|
format* | 리턴형식 [XML, JSON, NVP] |
리턴샘플
5 byte
|
price | 인증가격 옵션필드 (제외가능) |
64 byte
|
resultCode | 결과코드 "0000":성공, 이외 실패 (실패코드 6byte) |
6 byte
|
---|---|---|
resultMsg | 결과메세지 |
100 byte
|
timestamp | 타임스템프[TimeInMillis(Long형)] |
40 byte
|
tid | 거래번호 |
40 byte
|
mid | 상점아이디 |
10 byte
|
MOID | 주문번호 |
40 byte
|
selectPayMethod | 지불수단 |
10 byte
10 byte
|