모바일 에스크로 결제
KG이니시스 결제창을 호출하여 다양한 지불수단을 제공하는 매매보호 결제 서비스
Quick Guide
샘플 다운로드
개발 언어에 맞는 샘플을
다운로드 받아 주세요.
리턴 URL 수정
결과값을 수신받을 수 있는
P_NEXT_URL 과 P_NOTI_URL 을 설정해주세요.
테스트 실행 및 결과확인
결제 진행과정과
응답결과를 확인해 주세요.
실제 연동진행
가맹점 실서버 환경에 맞게
연동을 진행해주세요.
연동 준비하기
모바일결제 연동 전, 체크해야할 사항을 안내드립니다.
MID상점아이디
계약 완료 여부, 사용 가능 지불 수단 등은 계약담당자 문의금액위변조
Hashkey
(선택사항) 금액위변조 Hash 기능사용 시에만 필요한 key가맹점관리자 ▶ 상점정보 ▶ 계약정보 ▶ 부가정보 ▶ 모바일 금액위변조 Hashkey
방화벽정보
항목 | 스테이징환경 | 운영환경 |
---|---|---|
URL | stgmobile.inicis.com | fcmobile.inicis.com ksmobile.inicis.com |
IP | 118.129.210.154 | 118.129.210.57 183.109.71.50 |
PORT | 443 | |
연결방향 | OUTBOUND |
STEP 1결제요청
결제요청정보
- 결제요청 URL : https://mobile.inicis.com/smart/payment/
- HTTP Method : POST
- Accept-charset : EUC-KR
- 필수파라미터
- 선택파라미터
- 추가옵션(P_RESERVED)
P_INI_PAYMENT* | 요청지불수단 |
지불수단
10 byte
|
---|---|---|
P_MID* | 상점아이디 |
10 byte
|
P_OID* | 주문번호 반드시 Unique 값으로 생성 (거래추적 시 사용됨) |
40 byte
|
P_AMT* | 결제금액 숫지만 허용, 콤마(",") 사용불가 |
64 byte
|
P_GOODS* | 상품명 |
80 byte
|
P_UNAME* | 구매자명 |
30 byte
|
P_NEXT_URL* | 결과수신 URL |
N/A
|
P_NOTI_URL | 가상계좌입금통보 URL 가상계좌 결제 시 필수 |
N/A
|
P_HPP_METHOD | 휴대폰결제 상품유형 [1:컨텐츠, 2:실물] 휴대폰결제 시 필수 |
1 byte
|
P_RESERVED* | "centerCd=Y" IDC센터코드 수신 사용옵션 세팅 필수 ex) P_RESERVED = centerCd=Y 여러옵션 추가 세팅 시 "&"(엠퍼센트) 구분자 사용 |
N/A
|
P_QUOTABASE | 할부개월수 노출옵션 [할부개월:할부개월] 금액이 할부조건일 경우 동작 ex) 세팅 예시 일시불 세팅 시, value="00" 2~6개월 세팅 시, value="02:03:04:05:06" |
신용카드
N/A
|
---|---|---|
P_CARD_OPTION | 신용카드 우선선택 옵션 [selcode=카드코드] 설정한 카드코드에 해당하는 카드가 선택된 채로 Display 됩니다. |
신용카드
10 byte
|
P_ONLY_CARDCODE | 결제 카드사 선택 노출옵션 [카드코드:카드코드] Default: 결제가능한 모든 카드사 표시 |
신용카드
N/A
|
P_VBANK_DT | 가상계좌 입금기한 날짜 [YYYYMMDD] Default: 요청일 +10일로 자동설정 |
가상계좌
8 byte
|
P_VBANK_TM | 가상계좌 입금기한 시간 [hhmm] |
유의사항
가상계좌
4 byte
|
P_TAX | 부가세 "부가세 업체정함" 계약가맹점만 설정필요. |
64 byte
|
P_TAXFREE | 비과세 (면세상품 금액) "부가세 업체정함" 계약가맹점만 설정필요 |
64 byte
|
P_CHARSET | 결과 수신 인코딩 [utf8, euc-kr] Default: euc-kr |
6 byte
|
P_MOBILE | 구매자 휴대폰번호 숫자와 "-" 만 허용 |
15 byte
|
P_EMAIL | 구매자 이메일 주소 "@", "." 외 특수문자 입력불가 |
30 byte
|
P_MNAME | 가맹점 이름 |
N/A
|
P_LANG | 결제창 언어 설정 ["ko":국문, "en":영문] Default: "ko":국문 |
2 byte
|
P_LOGO_URL | 결제창 헤더 상단 이미지 변경필드 URL 을 전송 시 해당 URL 의 이미지 로딩 P_INI_PAYMENT = NOAUTHCARD (비인증결제) 일 때만 세팅가능 |
N/A
|
P_NOTI | 가맹점 임의 데이터 |
600 byte
|
P_TIMESTAMP | 타임스템프 [TimeInMillis(Long형)] 모바일 금액위변조 옵션 P_RESERVED="amt_hash=Y" 세팅 시 필수 |
20 byte
|
P_CHKFAKE | BASE64_ENCODE(SHA512(Data)) HASH 값 대상파라미터 : P_AMT + P_OID + P_TIMESTAMP + HashKey 모바일 금액위변조 옵션 P_RESERVED="amt_hash=Y" 세팅 시 필수 |
HASH
N/A
|
P_RESERVED | 지불수단별 추가옵션 상단 [추가옵션] 탭 참고 |
N/A
|
※ P_RESERVED 세팅예시 옵션 구분자 "&"(앰퍼센트) |
|||
---|---|---|---|
P_RESERVED | useescrow=Y* | 신에스크로 사용옵션 신에스크로 계약가맹점만 사용 |
에스크로
|
P_RESERVED | centerCd=Y * | IDC센터코드 수신 사용옵션 |
공통
|
amt_hash=Y | 모바일 금액위변조 hash검증 사용옵션 amt_hash=Y 일때, P_TIMESTAMP, P_CHKFAKE 파라미터 세팅 필수 |
유의사항
공통
|
|
P_RESERVED | below1000=Y | 신용카드 결제 시 1000원 이하금액 결제가능 옵션 |
신용카드
|
merc_noint=Y& noint_quota=카드코드-개월:개월^카드코드-개월:개월 |
상점부담 무이자할부 옵션 "상점부담무이자" 계약 가맹점만 사용 |
신용카드
|
|
d_card=카드코드& d_quota=할부개월 |
신용카드 결제창 직접호출 옵션 별도계약시 사용가능 |
신용카드
|
|
cp_yn=Y | 신용카드 포인트 사용여부 별도계약시 사용가능 |
신용카드
|
|
global_visa3d=Y | 해외카드 노출 옵션 |
신용카드
|
|
app_scheme=앱스키마명:// | (IOS의 경우)
가맹점APP 및 타사앱을 통해 결제진행 시 설정 지원가능 지불수단 : ISP, 은련카드, LPAY, PAYCO |
신용카드
|
|
apprun_check=Y |
(Android의 경우)
intent:// 호출 (IOS의 경우) ISP 인증완료 후 확인버튼 클릭 시, 인증이 되지 않았다면 다시 ISP 앱 호출 |
신용카드
|
|
P_RESERVED | d_kwpy=Y | 뱅크월렛 바로가기 옵션 |
계좌이체
|
bank_receipt=N | 현금영수증 UI 미노출 옵션 Default: 현금영수증 UI 노출 |
계좌이체
|
|
iosapp=Y& app_scheme=앱스키마명:// |
(IOS의 경우)
가맹점APP 및 타사앱을 통해 결제진행 시 설정 지원가능 지불수단 : 뱅크페이, 뱅크월렛 |
계좌이체
|
|
P_RESERVED | vbank_receipt=Y | 현금영수증 UI 노출 옵션 Default: 현금영수증 UI 미노출 |
가상계좌
|
P_RESERVED | hpp_corp=통신사 | 휴대폰결제 업체지정 옵션 [SKT, KTF, LGT] 중복지정 시 구분자 ":"(콜론) |
휴대폰
|
STEP 2인증결과
P_STATUS | 결과코드 "00":성공, 이외 실패 |
4 byte
|
---|---|---|
P_RMESG1 | 결과메시지 |
10 byte
|
P_TID | 인증거래번호 성공시에만 전달 |
40 byte
|
P_AMT | 거래금액 |
8 byte
|
idc_name | IDC센터코드 [fc, ks, stg] 승인요청 시 P_REQ_URL 과 비교검증 필요 |
CODE
N/A
|
P_REQ_URL | 승인요청 URL 해당 URL로 HTTPS API Request 승인요청 - POST 이니시스 제공 승인API 가 맞는지 확인 필요 (IDC센터코드와 비교 검증 필요) |
N/A
|
P_NOTI | 가맹점 임의 데이터 |
600 byte
|
STEP 3승인요청
승인요청 정보
- 승인요청 URL : STEP2 인증결과 수신 시 응답된 P_REQ_URL
이니시스 제공 승인API 가 맞는지 확인 필요 (IDC센터코드와 비교 검증 필요) - Content-type: application/x-www-form-urlencoded
- HTTP Method : POST
- 통신방식 : http-Client 통신
P_MID* | 상점아이디 결제요청 시 세팅한 P_MID 와 동일한 값 세팅 |
10 byte
|
---|---|---|
P_TID* | 인증거래번호 |
40 byte
|
STEP 4승인결과
※ 유의사항
해당 응답파라미터는 모든 프로세스 종료 후 최종적으로 전달되는 결과값 입니다.
- 응답파라미터는 추후 요건에 의해 추가될 수 있습니다.
- 실패 응답 시, 일부 파라미터 응답이 null 일 수 있습니다.
- 공통
- 신용카드
- 계좌이체/가상계좌/휴대폰
- 현금영수증
P_STATUS | 결과코드 "00":성공, 이외 실패 (실패코드 4byte) |
4 byte
|
---|---|---|
P_RMESG1 | 결과메세지 |
500 byte
|
P_TID | 거래번호 |
40 byte
|
P_MID | 상점아이디 |
10 byte
|
P_OID | 주문번호 |
100 byte
|
P_AMT | 거래금액 |
8 byte
|
P_TYPE | 지불수단 |
지불수단
N/A
|
P_AUTH_DT | 승인일자 [YYYYMMDDhhmmss] |
14 byte
|
P_UNAME | 구매자명 |
30 byte
|
P_MNAME | 가맹점명 결제요청 정보에 입력된 값 반환 |
N/A
|
P_NOTI | 가맹점 임의 데이터 |
600 byte
|
P_NOTEURL | 가맹점 전달 P_NOTI_URL |
N/A
|
P_NEXT_URL | 가맹점 전달 P_NEXT_URL |
N/A
|
P_AUTH_NO | 승인번호 |
신용카드
30 byte
|
---|---|---|
P_CARD_NUM | 신용카드번호 |
신용카드
16 byte
|
P_CARD_INTEREST | 상점부담 무이자 할부여부 ["1":상점부담 무이자] |
신용카드
1 byte
|
P_RMESG2 | 카드 할부기간 |
신용카드
500 byte
|
P_FN_CD1 | 카드사 코드 |
신용카드
4 byte
|
P_FN_NM | 결제카드사 한글명 |
신용카드
N/A
|
CARD_CorpFlag | 카드구분 ["0":개인카드, "1":법인카드, "9":구분불가] |
신용카드
1 byte
|
P_CARD_CHECKFLAG | 카드종류 ["0":신용카드, "1":체크카드, "2":기프트카드] |
신용카드
1 byte
|
P_CARD_PRTC_CODE | 부분취소 가능여부 ["1":가능 , "0":불가능] |
신용카드
1 byte
|
P_CARD_ISSUER_CODE | 카드발급사(은행) 코드 |
신용카드
2 byte
|
P_ISP_CARDCODE | VP 카드코드 |
신용카드
15 byte
|
P_SRC_CODE | 간편(앱)결제구분 |
신용카드
1 byte
|
P_CARD_MEMBER_NUM | 가맹점번호 자체가맹점인 경우만 |
신용카드
9 byte
|
P_CARD_PURCHASE_CODE | 매입사코드 자체가맹점인 경우만 |
신용카드
2 byte
|
P_CARD_USEPOINT | 포인트 사용금액 |
신용카드
12 byte
|
P_COUPONFLAG | 쿠폰사용 유무 ["1":사용] |
신용카드
1 byte
|
P_COUPON_DISCOUNT | 쿠폰(즉시할인) 금액 |
신용카드
N/A
|
P_CARD_APPLPRICE | 승인요청 금액 |
신용카드
N/A
|
P_CARD_COUPON_PRICE | 실제 카드승인 금액 |
신용카드
N/A
|
NAVERPOINT_UseFreePoint | 네이버포인트 무상포인트 |
신용카드
12 byte
|
NAVERPOINT_CSHRApplYN | 네이버포인트 현금영수증 발행여부 ["Y":발행, "N":미발행] |
신용카드
1 byte
|
NAVERPOINT_CSHRApplAmt | 네이버포인트 현금영수증 발행 금액 |
신용카드
12 byte
|
PCO_OrderNo | 페이코 주문번호 |
신용카드
N/A
|
CARD_EmpPrtnCode | 롯데카드 임직원 제휴 구분코드 ["L":임직원] 롯데카드인 경우만 임직원 구분코드 전달 |
신용카드
1 byte
|
CARD_NomlMobPrtnCode | 카드사 제휴구분코드 ["P":롯데카드일반, "M":롯데카드모바일, "H":현대카드(통합)] |
신용카드
N/A
|
P_FN_CD1 | 은행코드 |
계좌이체
2 byte
|
---|---|---|
P_FN_NM | 결제은행 한글명 |
계좌이체
N/A
|
P_VACT_NUM | 가상계좌번호 |
입금통보
가상계좌
14 byte
|
P_VACT_BANK_CODE | 입금은행코드 |
가상계좌
2 byte
|
P_FN_NM | 입금은행명 |
가상계좌
N/A
|
P_VACT_NAME | 예금주명 |
가상계좌
18 byte
|
P_VACT_DATE | 입금기한일자 [YYYYMMDD] |
가상계좌
8 byte
|
P_VACT_TIME | 입금기한시각 [hhmmss] |
가상계좌
6 byte
|
P_HPP_NUM | 휴대폰번호 |
휴대폰
11 byte
|
P_HPP_CORP | 휴대폰통신사 [*** 고정] |
휴대폰
3 byte
|
P_CSHR_CODE | 결과코드 ["0000":정상, 그외 실패] |
현금영수증
6 byte
|
---|---|---|
P_CSHR_MSG | 결과메세지 |
현금영수증
N/A
|
P_CSHR_AMT | 현금영수증 총 금액 [총금액 = 공급가액+세금+봉사료] |
현금영수증
N/A
|
P_CSHR_SUP_AMT | 공급가액 |
현금영수증
N/A
|
P_CSHR_TAX | 부가세 |
현금영수증
N/A
|
P_CSHR_SRVC_AMT | 봉사료 |
현금영수증
N/A
|
P_CSHR_TYPE | 용도구분 ["0":소득공제, "1":지출증빙] |
현금영수증
1 byte
|
P_CSHR_DT | 발행일시 [YYYYMMDDhhmmss] |
현금영수증
14 byte
|
P_CSHR_AUTH_NO | 발행 승인번호 가상계좌는 채번시점에선 미전달 (입금통보로 전달) |
현금영수증
9 byte
|
(예외) 망취소처리 요청
망취소요청 정보
가맹점에서 승인결과 전문 처리 중 예외발생 시 망취소 요청할 수 있습니다.
※ 망취소 요청가능시간 : 인증TID 기준 10분 이내, 승인TID 기준 1분 이내
※ 망취소를 일반 결제취소 용도로 사용하지 마십시오.
※ 망취소요청URL HOST 값을 절대로 고정으로 사용하지 마십시오.
- 망취소요청 URL : {인증결과 전달된 P_REQ_URL의 HOST}/smart/payNetCancel.ini
- Content-type: application/x-www-form-urlencoded
- HTTP Method : POST
- 통신방식 : http-Client 통신
- 망취소 요청
- 망취소 응답
P_TID* | 인증결과로 전달된 인증TID 일반적으로 INIMX_AUTH, INIMX_AISP 등으로 시작 |
40 byte
|
---|---|---|
P_MID* | 결제요청 시 설정한 P_MID 값 |
10 byte
|
P_AMT* | 결제요청 시 설정한 P_AMT 값 |
12 byte
|
P_OID* | 결제요청 시 설정한 P_OID 값 |
40 byte
|
P_TIMESTAMP (선택(권장)) |
타임스템프 [TimeInMillis(Long형)] P_CHKFAKE 세팅 시 반드시 함께 세팅필요 |
20 byte
|
P_CHKFAKE (선택(권장)) |
BASE64_ENCODE(SHA512(Data)) HASH 값 대상파라미터 : P_AMT + P_OID + P_TIMESTAMP + HashKey |
HASH
N/A
|
P_STATUS | 결과코드 "00":성공, 이외 실패 |
2 byte
|
---|---|---|
P_RMESG1 | 결과메세지 |
100 byte
|
P_TID | 취소된 거래에 대한 승인TID |
40 byte
|