INIpay Mobile

INIpayMobile 모바일 웹 기반의 결제서비스 입니다.
본메뉴얼은 결제 연동과 관련된 필수적인 사항을 안내하며,
상세 내용은 별도 배포되는 모바일 연동가이드를 참고바랍니다.

상세메뉴얼 확인

방화벽정보

INIpayMobile 서비스 통신을 위해서는 아래의 가맹점 방화벽이 허용되어 있어야합니다.
항목 설명
연결방향 OUTBOUND
IP 118.129.210.57(fcmobile.inicis.com),
183.109.71.50(ksmobile.inicis.com)
프로토콜 TCP
PORT 443 (https)

결제요청

모바일 결제창 호출에 대한 URL 및 파라미터에 대해 안내합니다.

URL : https://mobile.inicis.com/smart/payment/
HTTP Method : POST
accept-charset : euc-kr
<<모바일 결제요청>>
파라미터 설명 SIZE(byte) Require
P_INI_PAYMENT CARD(신용카드),
MOBILE(휴대폰),
BANK(계좌이체),
VBANK(가상계좌)
10
P_MID 발급받은 상점 MID 10
P_GOODS 상품명 80
P_OID 상점주문번호 40
P_AMT 결제금액(숫지만, 콤마(",") 사용불가) 8
P_UNAME 구매자 이름 30
P_EMAIL 구매자 이메일 주소 30
P_NEXT_URL 결제완료후 인증결과 수신 URL 250
P_NOTI 가맹점 정보필드 600
P_NOTI_URL 가상계좌입금통보 URL 가이드 250 가상계좌필수

인증결과

사용자가 결제페이지에서 인증을 완료하면 P_NEXT_URL로 인증결과를 전달합니다.

HTTP Method : GET/POST
<<인증결과 파라미터>>
파라미터 설명 SIZE
P_STATUS "00" : 성공, 이외 실패 10
P_RMESG1 결과메시지 4
P_TID 인증거래번호(성공시에만 전달) 40
P_REQ_URL 승인요청 URL(거래마다 상이)
P_NOTI 가맹점정보필드 600
P_AMT 거래금액 8

승인요청

P_NEXT_URL로 응답받은 P_STATUS 값이 "00"인 경우, 최종 승인처리를 위해 P_REQ_URL로 승인을 요청하세요.

URL : 인증결과의 P_REQ_URL
Method : POST
<<승인요청 파라미터>>
파라미터 설명 SIZE Require
P_MID 주문요청 시 사용한 P_MID 10
P_TID 인증거래번호 40

승인응답

승인요청이 완료된 요청에 대한 결과 값이 전달됩니다.
지불수단별로 상이하며 상세 파라미터는 아래를 참고바랍니다.

<<승인응답 파라미터>>
지불수단 파라미터 정의 설명
공통 P_STATUS 거래상태 "00":성공, 이외 : 실패 INFO
P_RMESG1 지불결과메시지 500byte
P_TID 승인거래번호 40byte
P_TYPE 지불수단 CARD(ISP,안심클릭),
MOBILE(휴대폰),
BANK(계좌이체),
VBANK(가상계좌)
P_AUTH_DT 승인일자 YYYYMMDDhhmmss
P_MID 상점아이디 10byte
P_OID 상점 주문번호 100byte
P_AMT 8byte
P_UNAME 주문자명 30byte
P_MNAME 가맹점명 주문정보에 입력된 값 반환
P_NOTI 주문정보에 입력한 값 반환 600byte
P_NOTEURL 가맹점 전달 NOTI_URL 주문정보에 입력한 값 반환
P_NEXT_URL 가맹점 전달 NEXT_URL 주문정보에 입력한 값 반환
신용카드 P_CARD_ISSUER_CODE 발급사 코드 2byte
P_CARD_MEMBER_NUM 가맹점번호 자체가맹점인 경우
P_CARD_PURCHASE_CODE 매입사 코드 자체가맹점인 경우
P_CARD_PRTC_CODE 부분취소 가능여부 0:불가능, 1:가능
P_CARD_INTEREST 무이자 할부여부 0:일반, 1:무이자
P_CARD_CHECKFLAG 체크카드 여부 0:신용, 1:체크, 2:기프트
P_RMESG2 신용카드할부개월 500byte
P_FN_CD1 카드코드 4byte
P_AUTH_NO 승인번호 신용카드 거래에만 사용, 30byte
P_ISP_CARDCODE VP 카드코드
P_FN_NM 결제카드한글명 BC카드,신한카드 등
앱연동구분 P_SRC_CODE 앱연동여부 K:국민앱카드,
C:페이코,
B:삼성페이,
L:L.pay,
O:카카오페이,
G:SSGPAY,
H:토스페이
I : 네이버페이(대문자 i)
계좌이체 P_FN_CD1 은행코드 2byte
P_FN_NM 결제은행 한글명
휴대폰 P_HPP_CORP 휴대폰통신사 *** 고정
P_HPP_NUM 결제 휴대폰번호
가상계좌 P_VACT_NUM 입금할 계좌번호 20byte
P_VACT_DATE 입금마감일자 YYYYMMDD
P_VACT_TIME 입금마감시간 hhmmss
P_VACT_NAME 계좌주명
P_VACT_BANK_CODE 은행코드 2byte
현금영수증 P_CSHR_CODE 처리상태 220000:정상, 그외: 오류
P_CSHR_MSG 처리메시지
P_CSHR_AMT 현금영수증 총 금액 총금액 = 공급가액+세금+봉사료
P_CSHR_SUP_AMT 공급가액
P_CSHR_TAX 세금
P_CSHR_SRVC_AMT 봉사료
P_CSHR_TYPE 용도구분 0:소득공제, 1:지출증빙
P_CSHR_DT 발행시간
P_CSHR_AUTH_NO 발행번호 가상계좌는 채번시점에선 미전달
KPAY P_KPAY_APPL_PRICE KPAY 실 승인금액 *KPAY 결제 시에만 전달
P_KPAY_PAYMETHOD KPAY 지불수단 CARD, ISP, HPP
*KPAY 결제 시에만 전달
P_KPAY_QUOTA KPAY 할부개월 char(2)
*KPAY 결제 시에만 전달
P_KPAY_INST KPAY 무이자구분 0:일반, 1:무이자
*KPAY 결제 시에만 전달
P_KPAY_CHECK_FLG KPAY 카드구분 0:신용, 1:체크, 2:기프트
*KPAY 결제 시에만 전달

가상계좌입금통보

가상계좌 입급통보 등 P_NOTI_URL을 통한 지불결과 통보에 대해 안내합니다.

노티전달은 정상적으로 결제 데이터를 받을 때까지 반복 호출됩니다.
정상적으로 데이터를 전달받으셨다면 응답 값으로 OK 를 출력해주셔야 노티가 추가적으로 전송되지 않습니다.
노티페이지(P_NOTI_URL)는 이니시스에서 백엔드로 호출을 하는 페이지로, 고객이 보는 결제 화면과는 무관합니다.
입금통보 외 채번시에도 노티가 전달되며, 채번 시 노티로 전달되는 내용은 무시하시기 바랍니다.
노티 수신을 위해서는 아래 방화벽 허용이 필요합니다.
IP : 118.129.210.25, 183.109.71.153, 203.238.37.15
방향 : INBOUND
<<노티 전송 파라미터>>
파라미터 필드명 크기 설명
P_STATUS 거래상태 2 02:가상계좌입금통보
P_TID 거래번호 40
P_TYPE 지불수단 10 VBANK(가상계좌)
P_AUTH_DT 승인일자 14 YYMMDDhhmmss
P_MID 상점아이디 10
P_OID 상점주문번호 100
P_FN_CD1 은행코드 4
P_FN_CD2 금융사코드 10 빈값으로 전달
P_FN_NM 은행명 50
P_AMT 거래금액 12
P_UNAME 주문자명 30
P_RMESG1 메시지1 500 채번된 가상계좌번호|입금기한
예)P_VACCT_NO=01440064018781|P_EXP_DT=20100325
P_RMESG2 메시지2 500 빈값전달
P_NOTI 주문정보 4000 거래요청시 입력한 P_NOTI 값을 그대로 반환합니다.
P_AUTH_NO 승인번호 30 빈값전달
P_CSHR_AMT 현금영수증 거래 금액 12
P_CSHR_SUP_AMT 현금영수증 공급가액 12
P_CSHR_TAX 현금영수증 부가가치세 12
P_CSHR_SRVC_AMT 현금영수증 봉사료 12
P_CSHR_TYPE 현금영수증 거래자 구분 1 0 : 소비자 소득공제용 / 1 : 사업자 지출증빙용
P_CSHR_DT 현금영수증 발행일자 14 YYYYMMDDhhmmss
현금영수증 발행일자
P_CSHR_AUTH_NO 현금영수증 발행승인번호 9 현금영수증 발행승인번호
가상계좌입금통보 전달 형식은 아래와 같습니다.

POST {채번 요청 시 설정한 P_NOTI_URL}
Content-Type application/x-www-form-urlencoded;charset=euc-kr

P_STATUS=02&
P_TID=INIMX_VBNKINIpayTest120191030171516155319&
P_TYPE=VBANK&
P_AUTH_DT=20191030172157&
P_MID=INIpayTest&
P_OID=testoid1234567890&
P_FN_CD1=11&
P_FN_CD2=&
P_FN_NM=NH%B3%F3%C7%F9%C0%BA%C7%E0&
P_AMT=38400&
P_UNAME=%C0%AF%B8%ED%C7%F6&
P_RMESG1=P_VACCT_NO%3D79013683802571%7CP_EXP_DT%3D20191106&
P_RMESG2=&
P_NOTI={결제요청시 설정된 P_NOTI 정보}&
P_AUTH_NO=&
P_CSHR_AMT=&
P_CSHR_SUP_AMT=&
P_CSHR_TAX=&
P_CSHR_SRVC_AMT=&
P_CSHR_TYPE=&
P_CSHR_DT=20191030172157&
P_CSHR_AUTH_NO=123456789


에스크로 구매결정

모바일 결제창을 통한 에스크로 구매결정 연동에 안내합니다.
가맹점 페이지에 구매결정 버튼을 클릭하여 이니시스 구매결정 창이 호출되도록 구현하시면됩니다.

구매결정 연동 전문

<<구매결정 창 호출 파라미터>>
파라미터 설명 SIZE Require
P_INI_PAYMENT ESCROWCONFIRM(에스크로구매결정) 10
P_MID 주문요청 시 사용한 P_MID 10
P_ESCROW_TID 에스크로 결제 승인 TID 40
P_NEXT_URL 결과 수신 URL
* https(http)가 포함된 전체 URL이며, URL 내 get방식의 파라미터는 사용불가합니다.
800
P_NEXT_URL_TARGET 결과 수신 방법
선택 값 : socket, get, post (미입력시 기본 값:socket)
get, post 방식은 완료 후 가맹점 페이지로 해당 방식으로 전환되며, socket 방식은 NOTI로 해당 값을 통보하며 사용자페이지는 닫힙니다.
10
P_RESERVED 복합파라미터정보
P_RESERVED=escrow_purchase_opt=verify (구매확인버튼만 표시)
P_RESERVED=escrow_purchase_opt=verify (구매거절버튼만 표시)
옵션 미지정 시 구매확인/거절 모두 표시
100
<<에스크로 구매결정 응답>>
파라미터 설명 비고
P_ESCROW_TID 전달된 에스크로 TID
P_CL_STATUS 구매결정/구매거절여부 buyComplete / denyComplete
P_STATUS 상태값 구매결정, 구매거절에 대한 코드 값(하단 코드표 별첨)
P_RMESG1 처리결과메시지 urlEncode 전달
P_PG_IP 처리된 승인서버 IP

에스크로 상태 변경 노티 수신

노티발송(이니시스 -> 가맹점)
필드 필드명 필드사이즈 설명 비고
id_merchant 상점아이디 10 P_MID로 전달한 값
no_oid 주문번호 40 가맹점 주문번호
no_tid 거래번호 40 이니시스 제공 TID
cl_status 에스크로 상태 2 에스크로 상태구분 배송등록(2),구매확인(3),자동구매확인(31),강제구매확인(32),구매거절(4),거래취소(8),거절확인(10)
dt_req 요청일자 14 YYYYMMDDhhmmss
cl_paymethod 결제수단 2 에스크로 원 결제수단 신용카드(0),ISP(1),계좌이체(16),가상계좌(17)
msg_deny 구매 거절 사유 256 구매 거절 했을 경우 사유
price 거래금액 12 거래금액
tid_org 원거래 거래번호 40 부분 취소 시 원거래 거래번호 부분 취소 거래만 설정
노티응답(가맹점 -> 이니시스)
필드 필드명 필드사이즈 설명 비고
cd_rslt 결과코드 4 0000:정상처리,9999:처리실패 처리결과
msg_rslt 결과 메시지 1000 처리 실패시 해당 오류메시지 처리 결과 메시지
에스크로 주요 변경 시점(예>구매자가 이메일 상에서 구매결정(확정)을 완료 등)에 가맹점 측으로 해당 내역을 통보해주는 기능입니다. 상점 측에서는 정상 수신 여부를, 응답(NOTI CONFIRM)하여야 합니다. 해당 기능을 이용하려면 계약 담당자를 통해, 수신 받을 상점 측 URL 을 등록하여야 합니다
- 지불수단별, 승인 요청 시점의 주문번호를 기준으로 응답하며, 배송등록 시점에 사용되는 주문번호와 동일하게 설정을 권장합니다.
- 거래금액은 에스크로 상태에 따라 거래취소 시에는 취소금액, 그 외는 승인금액입니다.
- 원거래 TID 는 부분취소 거래만 설정됩니다.
※ 유의사항
- 에스크로 노티는 10분 간격으로 일괄 전송되는 구조로 한 건의 거래가 10분 내 상태가 변경되면 여러 건의 노티(에스크로 상태별)가 전송 될 수 있습니다.
- 가맹점에서는 에스크로 노티 데이터를 히스토리로 관리하여 최종 에스크로 상태를 구분해야 합니다.
예시) - 매시간 X0분에 에스크로 노티 전송
1. 05분 : 에스크로 상태 '2' (배송등록)
2. 07분 : 에스크로 상태 변경 '3' (구매확인)
3. 10분 : 에스크로 노티 처리시 배송등록과 구매확인에 대한 노티 전문 모두 전송(한건의 거래에 2번의 노티 전송)
- 노티 전문은 먼저 등록 요청된 순으로 전송됩니다. (배송등록 → 구매확인)
- 에스크로 노티 응답 실패시 재전송처리는 10회 수행됩니다.

사용자 취소시 응답

구매결정 진행 중 사용자가 취소버튼 클릭 시 아래와 같이 페이지가 전환됩니다.
이동 URL : P_NEXT_URL
전달 파라미터 : P_CANCEL=Y
Method : get
ex) 가맹점 파리미터가 없는 경우 {P_NEXT_URL}?P_CANCEL=Y
ex) 가맹점 파리미터가 있는 경우 {P_NEXT_URL?a=1}&P_CANCEL=Y

에스크로 구매결정 상태별 코드

상태별 응답 코드
P_STATUS P_RMESG1
00 정상 처리 완료
00 기 구매거절 거래
310004 결제 기통보 거래
310006 취소 불가 지불수단
310014 기 구매확인 거래
310015 구매확인 불가 거래상태
310017 구매거절 불가 거래상태
310020 구매결정 할 수 없는 상태
310026 원거래 없음
거래 상태별 응답
기존 상태 처리 요청 상태 P_STATUS P_CL_STATUS P_RMESG1
미정 구매결정성공 00 buyComplete 정상처리완료
미정 구매결정실패, 구매거부실패 에러코드 buyComplete, denyComplete 에러 메시지, 가변적
미정 구매거부성공 00 denyComplete 정상처리완료
기 구매거부 구매결정성공 00 buyComplete 기 구매거절 거래
기 구매거부 구매결정실패,구매거부실패 에러코드 buyComplete, denyComplete 에러 메시지, 가변적
기 구매거부 구매거부성공 00 denyComplete 기 구매거절 거래

주석



INFO
* 반드시 00 이외의 모든 결과는 실패로 처리하셔야 합니다. (지불수단 및 원천지불사의 에러내용에 따라 2~4자리로 전송될 수 있습니다. 모든 지불수단 공통적으로 결제성공 시 P_STATUS=00으로 전송되나, 결제실패 시에는 상이하게 전송될 수 있습니다.)