INIpay Standard

웹표준은 ActiveX 설치 없이 여러 지불수단을 이용하여 결제할 수 있도록 지원하는 인터넷 전자지불 서비스 입니다.
본매뉴얼은 결제 연동과 관련된 필수적인 사항을 안내하며,
상세 내용은 별도 배포되는 웹표준 연동가이드와 샘플코드를 참고바랍니다.

* 상세매뉴얼 및 샘플은 로그인 후 확인 가능합니다.
 

방화벽정보

웹표준 서비스 통신을 위해서는 아래의 가맹점 방화벽이 허용되어 있어야합니다.
항목 내용
연결방향 INBOUND, OUTBOUND
URL stdpay.inicis.com
fcstdpay.inicis.com
ksstdpay.inicis.com
IP 118.129.210.86
183.109.71.30
PORT 443

signature 개요

인증,승인 HTTPS POST 요청시 사용자의 위변조 방지를 위해 일부 데이터를 SHA256으로 Hash한 값 입니다.

인증요청(결제요청) 필수 데이터: oid, price, timestamp
승인요청 필수 데이터: authToken, timestamp

언어별 제공된 라이브러리 소스를 통해서 생성가능합니다.
생성방법: NVP 방식으로 연결한 데이터를 SHA256으로 Hash한 값 입니다.
*NVP 방식: oid=oidValue&price=priceValue&timestamp=timestampValue
  ex) oid=INIpayTest_1361252896871&price=1004&timestamp=1361252896871
   Hash 데이터: ec1e9c63ddad0b81f316ada2e3861e81db5f4f6652d9ff0f255b4cb5499ce893
주의: 필드 순서 유지(알파벳순), 마지막 &는 생략, 공백생략, 모든대상 필드는 Form에 설정되는 데이터와 동일한 값을 이용합니다.

결제요청

결제 인증 기본 요청 데이터 파라미터에 대해 안내합니다.

<<웹표준 결제요청>>
파라미터 설명 SIZE(byte) Require
version 전문 버전 (1.0) 20
mid 발급받은 상점 MID 10
oid 주문번호 40
goodsname 상품명 40
price 결제금액(숫지만, 1달러는 100으로 시작) 64
currency 통화구분(WON:한화,USD:달러 [USD는 카드 결제만 가능]) 3
buyername 구매자명(30Byte 초과 요청시 30Byte로 자동 변환) 30
buyertel 구매자 모바일 번호 20
timestamp 타임스템프 20
signature SHA256 Hash값 (oid, price, timestamp) signature 64
returnUrl 리턴 URL N/A
mKey 가맹점에 제공된 웹 표준 signKey를 해시값으로 변경 (SHA-256방식 사용) N/A
closeUrl 결제창 닫기 URL N/A
popupUrl 팝업처리 URL N/A
acceptmethod 결제수단별 옵션 (CARDPOINT:va_receipt:vbank(20201231):popreturn)

인증결과

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

<<인증결과 파라미터>>
파라미터 설명 SIZE
resultCode "0000": 정상, 이외 실패 10
resultMsg 결과메시지 (성공시 : 성공, 실패시 : 기타 오류 메시지) 100
mid 가맹점 ID 10
orderNumber 가맹점 주문번호 40
authToken 승인요청
authUrl 승인요청 Url (해당 URL로 HTTPS API Request 승인요청 - POST)
netCancelURl 망취소요청 Url (승인요청 후 인증결과 수신 실패 / DB저장 실패시)
charset 인증결과 인코딩 (default : UTF-8) 5
merchantData 가맹점 데이터 2000

승인요청

인증결과가 성공일때 authURL로 HTTPS API Request(httpClient 통신)를 통해 페이지 요청합니다.
승인요청은 인증결과 리턴 후 5분이내 이루어져야만 합니다.

<<승인요청 파라미터>>
파라미터 설명 SIZE Require
mid 가맹점 ID 10
authToken 인증결과코드
price 인증가격 64
timestamp 타임스템프 20
signature SHA256 Hash값 (authToken, timestamp)signature 64
charset 리턴 인코딩 5
format 리턴형식 (XML, JSON, NVP) 5

승인응답

승인 요청후 결과(responseBody)를 받아 요청타입(format)에 따라서 파싱 후에 내부처리(DB 저장 등) 하시기 바랍니다.
수신시 전송 필드명을 명확히하여 처리하시기 바랍니다. (파라미터 대/소문자 구분)
지불수단별로 상이하며 상세 파라미터는 아래를 참고바랍니다.

<<승인응답 파라미터>>
지불수단 파라미터 정의 설명
공통 resultCode 결과코드 "0000":성공, 이외: 실패
resultMsg 지불결과메시지 100byte
tid 거래번호 40byte
EventCode 이벤트 코드 카드 할부 및 행사 적용 코드
TotPrice 거래금액 20byte
MOID 주문번호 결제 요청시 oid 필드에 설정된 값
payMethod 지불수단 결제 방법
applNum 승인번호 결제수단에 따라 미전송
applDate 승인일자 YYYYMMDD
applTime 승인시간 hh24miss
buyerEmail 구매자 Email 60byte
custEmail 최종 Email 구매자가 결제최종확인 페이지에서 수정가능. 미수정 시 구매자 Email 값
buyerTel 구매자 모바일 번호 20byte
buyerName 구매자명 30byte
신용카드 CARD_Num 신용카드번호 16byte
CARD_Interest 할부여부 1byte
CARD_Quota 카드 할부기간 2byte
CARD_Code 카드사 코드 2byte
CARD_PRTC_CODE 부분취소 가능여부 "1":가능 , "0":불가능
CARD_BankCode 카드발급사 카드발급사(은행) 코드
CARD_SrcCode 간편(앱)결제구분 C:PAYCO
B:삼성페이
D:삼성페이(체크)
G:SSGPAY
O:KAKAOPAY
L:LPAY
K:국민카드앱
A:KPAY
CARD_Point 카드포인트 사용여부 "":카드 포인트 사용안함, "1":카드 포인트 사용
currency 통화코드 달러결제 정보, 통화코드
OrgPrice 달러 환전금액 해외카드 + 달러(USD) 결제 일 경우 환전금액
계좌이체 ACCT_BankCode 은행코드 2byte
CSHR_ResultCode 현금영수증 발 행 정상여부 220000(정상처리)
CSHR_Type 현금영수증구분 "0":소득공제, "1":지출증빙
ACCT_Name 계좌주명 30byte
무통장 VACT_Num 입금계좌번호 무통장입금 가상계좌번호
VACT_BankCode 입금은행코드 2byte
VACT_Name 예금주명 20byte
VACT_InputName 송금자명 입금 시 고객명
VACT_Date 송금 일자 8byte
VACT_Time 송금 시각 6byte
vactBankName 입금은행명 무통장 입금 은행명
휴대폰 HPP_Num 휴대폰번호 14byte
payDevice 결제장치 6byte