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:토스페이
계좌이체 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


주석

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