INIpay PRO 에스크로 결제
KG이니시스 결제창을 PC / 모바일 구분하지 않고 하나로 다양한 지불수단을 제공하는 매매보호 결제 서비스
Quick Guide
샘플 다운로드
개발 언어에 맞는 샘플을
다운로드 받아 주세요.
리턴 URL 수정
결과값을 수신받을 수 있는
P_NEXT_URL 과 P_NOTI_URL 을 설정해주세요.
테스트 실행 및 결과확인
결제 진행과정과
응답결과를 확인해 주세요.
실제 연동진행
가맹점 실서버 환경에 맞게
연동을 진행해주세요.
연동 준비하기
INIpay PRO 연동 전, 체크해야할 사항을 안내드립니다.
MID상점아이디
계약 완료 여부, 사용 가능 지불 수단 등은 계약담당자 문의금액위변조
Hashkey
금액위변조 Hash 기능사용 시에만 필요한 key가맹점관리자 ▶ 상점정보 ▶ 계약정보 ▶ 부가정보 ▶ 모바일 금액위변조 Hashkey
방화벽정보
| 항목 | 스테이징환경 | 운영환경 |
|---|---|---|
| URL | stgpaypro.inicis.com | fcpaypro.inicis.com kspaypro.inicis.com |
| IP | 183.109.71.64 | 118.129.210.23 183.109.71.35 |
| PORT | 443 | |
| 연결방향 | OUTBOUND | |
| 보안 프로토콜 | TLSv1.2 미만 브라우저 결제 불가 | |
STEP 1결제요청
결제요청 정보
- 결제요청 JS : https://paypro.inicis.com/std/payment/js/INIPayPro_v2.js
- HTTP Method : POST
- Accept-charset : UTF-8
- 필수파라미터
- 선택파라미터
- 추가옵션(P_RESERVED)
| P_MID* | 가맹점 아이디 |
10 byte
|
|---|---|---|
| P_OID* | 주문번호 반드시 Unique 값으로 생성 (거래추적 시 사용됨) |
40 byte
|
| P_PAY_TYPE* | 결제수단 [ 신용카드:"CARD", 계좌이체:"BANK", 가상계좌:"VBANK" ] 여러 지불수단 요청 (구분자 콜론 ':') - CARD:BANK:VBANK |
N/A
|
| P_DEVICE_TYPE* | 디바이스 타입 [ PC:"WEB", 모바일:"MOBILE" ] |
6 byte
|
| P_IDCCODE* | IDC 센터 코드 사용 [ "Y" 고정 ] |
1 byte
|
| P_AMT* | 결제금액 |
9 byte
|
| P_GOODS* | 상품명 |
80 byte
|
| P_UNAME* | 구매지명 |
30 byte
|
| P_NEXT_URL* | 인증결과 수신 URL |
500 byte
|
| P_NOTI_URL* | 가상계좌 입금통보 URL |
500 byte
|
| P_TIMESTAMP* | 타임스탬프 [TimeInMillis(Long형)] |
13 byte
|
| P_CHKFAKE* | BASE64_ENCODE(SHA512(DATA)) HASH 값 대상파라미터 : P_AMT + P_OID + P_TIMESTAMP + HashKey |
HASH
N/A
|
| P_RESERVED | 추가 옵션 [ JSON String ] 에스크로 옵션 {"useescrow":"Y"} 필수 세팅 상단 [추가옵션] 탭 참고 |
N/A
|
| P_CLOSE_URL | 결제창 닫기 URL 결제창 닫기 버튼 클릭 시 해당 URL로 이동 |
500 byte
|
|---|---|---|
| P_CHARSET | 결과 인코딩 옵션 [ "UTF-8" , "EUC-KR" ] |
6 byte
|
| P_TAX | 부가세 "부가세 업체정함" 계약 가맹점만 설정필요. 주의사항: 전체금액의 10%이하로 설정 |
9 byte
|
| P_TAXFREE | 비과세(면세) "부가세 업체정함" 계약 가맹점만 설정필요 |
9 byte
|
| P_NOTI | 가맹점 임의 데이터 |
600 byte
|
※ P_RESERVED 세팅예시 JSON String 형태 |
|||
|---|---|---|---|
| P_RESERVED | 구매자 이메일 |
공통
|
|
| phonenum | 구매자 전화번호 |
공통
|
|
| cupDeposit | 컵보증금 금액 |
공통
|
|
| useescrow | 에스크로결제 사용여부 [ 사용:"Y", 사용안함:"N" ] |
공통
|
|
| P_RESERVED | quotabase | 할부개월 수 노출 옵션 [ 할부개월:할부개월 ] |
신용카드
|
| only_cardcode | 카드 노출 옵션 [ 카드코드] |
카드코드
신용카드
|
|
| d_card | 신용카드 다이렉트 호출 옵션 [ 카드코드 ] |
카드코드
신용카드
|
|
| d_quota | 다이렉트 카드 할부개월 설정 [ 할부개월 수 ] 다이렉트 호출 시 해당 항목 필수 |
신용카드
|
|
| cardshowopt | 앱카드 다이렉트 호출 옵션 [ 카드코드 ] |
카드코드
신용카드
|
|
| merchant_noint | 상점부담 무이자 사용 여부 [ 사용:"Y", 미사용:"N" ] |
신용카드
|
|
| noint_quota | 상점부담 무이자할부 옵션 [ 카드코드-개월:개월^카드코드-개월:개월 ] "상점부담무이자" 계약 가맹점만 사용 |
신용카드
|
|
| P_RESERVED | bank_receipt | 현금영수증 UI 미노출 옵션 [ 미노출 : "N" ] Default: 현금영수증 UI 노출 |
계좌이체
|
| P_RESERVED | vbank_receipt | 현금영수증 UI 미노출 옵션 [ 미노출 : "N" ] Default: 현금영수증 UI 노출 |
가상계좌
|
| vbank_dt | 무통장입금 입금기한 날짜 [ YYYYMMDD ] |
가상계좌
|
|
| vbank_tm | 무통장입금 입금기한 시간 [ hhmm ] |
가상계좌
|
|
STEP 2인증결과
| P_STATUS | 결과코드 "00":성공, 이외 실패 |
4 byte
|
|---|---|---|
| P_RMESG | 결과메시지 |
100 byte
|
| P_MID | 가맹점 아이디 |
10 byte
|
| P_AUTH_TID | 인증거래번호 |
40 byte
|
| P_OID | 주문번호 |
40 byte
|
| P_AMT | 거래금액 |
9 byte
|
| P_IDCNAME | IDC센터코드 [ fc, ks, stg ] |
N/A
|
| P_NOTI | 가맹점임의데이터 |
600 byte
|
| P_CHARSET | 인코딩 옵션 [ "UTF-8" , "EUC-KR" ] |
6 byte
|
| P_TYPE | 지불수단 은련페이 승인결과 파라미터 |
N/A
|
| P_APPL_DT | 승인 날짜 은련페이 승인결과 파라미터 |
8 byte
|
| P_APPL_TM | 승인 시간 은련페이 승인결과 파라미터 |
6 byte
|
| P_UNAME | 구매자명 은련페이 승인결과 파라미터 |
30 byte
|
STEP 3승인요청
승인요청 정보
- 승인요청 URL : https://{P_IDCNAME}paypro.inicis.com/payment/v1/rest/payAppl.ini
- Content-type: application/x-www-form-urlencoded
- HTTP Method : POST
- 통신방식 : http-Client 통신
| P_MID* | 상점아이디 결제요청 시 세팅한 P_MID 와 동일한 값 세팅 |
10 byte
|
|---|---|---|
| P_AUTH_TID* | 인증거래번호 |
40 byte
|
| P_AMT* | 결제금액 |
9 byte
|
| P_CHARSET | 결과 인코딩 옵션 [ "UTF-8" , "EUC-KR" ] Default: UTF-8 |
6 byte
|
STEP 4승인결과
※ 유의사항
승인결과 파라미터는 모든 결제 프로세스 종료 후 최종적으로 전달되는 응답파라미터 입니다.
- 응답파라미터는 추후 요건에 의해 추가될 수 있습니다.
- 실패 응답 시, 일부 파라미터 응답이 null 일 수 있습니다.
- 공통
- 신용카드
- 계좌이체/가상계좌
- 현금영수증
| P_STATUS | 결과코드 "00":성공, 이외 실패 (실패코드 4byte) |
4 byte
|
|---|---|---|
| P_RMESG | 결과메세지 |
500 byte
|
| P_MID | 상점아이디 |
10 byte
|
| P_OID | 주문번호 |
40 byte
|
| P_AUTH_TID | 인증거래번호 |
40 byte
|
| P_APPL_TID | 승인거래번호 |
40 byte
|
| P_APPL_DT | 승인날짜 [YYYYMMDD] |
8 byte
|
| P_APPL_TM | 승인시간 [hhmmss] |
6 byte
|
| P_AMT | 거래금액 |
9 byte
|
| P_TYPE | 지불수단 [ 신용카드:"CARD", 계좌이체:"BANK", 가상계좌:"VBANK" ] |
N/A
|
| P_UNAME | 구매자명 |
30 byte
|
| P_NOTI | 가맹점 임의 데이터 |
600 byte
|
| P_MNAME | 가맹점명 |
N/A
|
| P_NEXT_URL | 인증결과수신 URL |
500 byte
|
| P_NOTEURL | 가맹점 전달 P_NOTI_URL |
500 byte
|
| P_EMAIL | 구매자 이메일 |
30 byte
|
| P_APPL_NO | 승인번호 |
신용카드
8 byte
|
|---|---|---|
| P_FN_CD1 | 카드코드 |
신용카드
2 byte
|
| P_CARD_NUM | 카드번호 보안을 위해 일부 카드번호 마스킹('*') 처리 |
신용카드
16 byte
|
| P_CARD_ISSUER_CODE | 발급사코드 |
신용카드
2 byte
|
| P_CARD_MEMBER_NUM | 가맹점번호 자체 가맹점일 경우에만 해당 |
신용카드
15 byte
|
| P_CARD_PURCHASE_CODE | 매입사코드 |
신용카드
2 byte
|
| P_CARD_PRTC_CODE | 부분취소 가능여부 [ '1':가능, '0':불가능 ] |
신용카드
1 byte
|
| P_CARD_INTEREST | 상점 부담 무이자 할부여부 [ '1':무이자, '0':일반 ] |
신용카드
1 byte
|
| P_CARD_CHECKFLAG | 카드종류 [ '0':신용카드, '1':체크카드, '2':기프트카드 ] |
신용카드
1 byte
|
| P_CARD_ISSUER_NAME | 카드발급사명 |
신용카드
20 byte
|
| P_CARD_PURCHASE_NAME | 카드매입사명 |
신용카드
20 byte
|
| P_FN_NM | 결제카드한글명 |
신용카드
100 byte
|
| CARD_CorpFlag | 개인/법인카드 구분 [ '0':개인카드, '1':법인카드, '9':구분불가 ] |
신용카드
1 byte
|
| P_ISP_CARDCODE | VP카드코드 |
신용카드
25 byte
|
| P_SRC_CODE | 간편(앱)결제구분 |
신용카드
1 byte
|
| P_EVENT_CODE | 이벤트구분 |
신용카드
1 byte
|
| P_COUPONFLAG | 쿠폰할인서비스 사용여부 [ "0":미사용, "1":신용카드 쿠폰할인, "2":체크카드 쿠폰할인] |
신용카드
1 byte
|
| P_COUPON_DISCOUNT | 쿠폰할인서비스 할인금액 |
신용카드
12 byte
|
| P_CARD_APPLPRICE | 승인요청금액 |
신용카드
12 byte
|
| P_CARD_DISCOUNT_PRICE | 카드 할인금액 KG시너지 파파존스 제휴 포인트 사용금액( 현대, 삼성, 씨티) |
신용카드
12 byte
|
| P_CARD_COUPON_PRICE | 쿠폰할인된 금액 |
신용카드
10 byte
|
| P_CARD_USEPOINT | 포인트 사용금액 |
신용카드
12 byte
|
| P_ORGCURRENCY | 해외결제 통화 |
신용카드
3 byte
|
| NAVERPOINT_CSHRApplYN | 네이버포인트 현금영수증 발행여부 [ "Y":발행함, "N":미발행] |
신용카드
1 byte
|
| NAVERPOINT_UseFreePoint | 네이버포인트 무상 포인트 |
신용카드
12 byte
|
| NAVERPOINT_CSHRApplAmt | 네이버 포인트 현금영수증 발행 금액 |
신용카드
12 byte
|
| CARD_EmpPrtnCode | 롯데카드 임직원 제휴 구분코드 [ "L":임직원 ] 롯데카드인 경우에만 입직원 구분코드 전달 |
신용카드
N/A
|
| SSG_CashReceipt | SSG 현금영수증 사용 [ "0":미발행, "1":소득공제, "2":지출증빙 ] |
신용카드
2 byte
|
| SSG_CSHRInfo | SSG 현금영수증 정보 [ 소득공제:휴대폰번호, 지출증빙:사업자번호 ] |
신용카드
11 byte
|
| SSG_CSHRApplAmt | SSG 현금영수증 처리 금액 |
신용카드
12 byte
|
| P_CARD_COUPON_DISCOUNT | 쿠폰할인서비스 할인금액 |
신용카드
2 byte
|
| PCO_OrderNo | 페이코 주문번호 응답 필드 |
신용카드
N/A
|
| P_FN_CD1 | 은행(발급사)코드 |
계좌이체
가상계좌
2 byte
|
|---|---|---|
| P_FN_NM | 결제은행한글명 |
계좌이체
가상계좌
100 byte
|
| P_VACT_NUM | 입금할 계좌 번호 |
가상계좌
14 byte
|
| P_VACT_DATE | 입금마감일자 [ YYYYMMDD ] |
가상계좌
8 byte
|
| P_VACT_TIME | 입금마감시간 [ hhmmss ] |
가상계좌
6 byte
|
| P_VACT_NAME | 계좌주명 |
가상계좌
18 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 : https://{P_IDCNAME}paypro.inicis.com/payment/v1/rest/payNetCancel.ini
- Content-type: application/x-www-form-urlencoded
- HTTP Method : POST
- 통신방식 : http-Client 통신
- 망취소 요청
- 망취소 응답
| P_MID* | 결제요청 시 설정한 P_MID 값 |
10 byte
|
|---|---|---|
| P_AUTH_TID* | 인증거래번호 |
40 byte
|
| P_AMT* | 결제요청 시 설정한 P_AMT 값 |
9 byte
|
| P_OID* | 결제요청 시 설정한 P_OID 값 |
40 byte
|
| P_CANCEL_MSG* | 망취소 메시지 |
100 byte
|
| P_TIMESTAMP* | 타임스탬프 [TimeInMillis(Long형)] |
13 byte
|
| P_CHKFAKE* | BASE64_ENCODE(SHA512(Data)) HASH 값 대상파라미터 : P_AMT + P_OID + P_TIMESTAMP + HashKey |
HASH
N/A
|
| P_CHARSET | 결과 인코딩 옵션 [ "UTF-8" , "EUC-KR" ] Default: UTF-8 |
6 byte
|
| P_STATUS | 결과코드 "00":성공, 이외 실패 |
4 byte
|
|---|---|---|
| P_RMESG | 결과메세지 |
100 byte
|
| P_CANCEL_MSG | 망취소 메시지 |
100 byte
|
| P_APPL_TID | 취소된 거래에 대한 승인TID |
40 byte
|
