| 항목 | 내용 |
|---|---|
| 연결방향 | INBOUND, OUTBOUND |
| URL |
stdpay.inicis.com fcstdpay.inicis.com ksstdpay.inicis.com |
| IP |
118.129.210.86 183.109.71.30 |
| PORT | 443 |
| 파라미터 | 설명 | 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) | ○ |
| 파라미터 | 설명 | 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 |
| 파라미터 | 설명 | SIZE | Require |
|---|---|---|---|
| mid | 가맹점 ID | 10 | ● |
| authToken | 인증결과코드 | ● | |
| price | 인증가격 | 64 | ● |
| timestamp | 타임스템프 | 20 | ● |
| signature | SHA256 Hash값 (authToken, timestamp)signature | 64 | ● |
| charset | 리턴 인코딩 | 5 | ● |
| format | 리턴형식 (XML, JSON, NVP) | 5 | ● |
| 지불수단 | 파라미터 | 정의 | 설명 |
|---|---|---|---|
| 공통 | 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 |