승인 대사
KG이니시스를 통해 승인(취소)된 데이터와 가맹점에서 자체 관리되는 데이터 일치여부 확인을 위한 거래데이터 조회 서비스
STEP1승인대사 조회
※ 유의사항
- 지불수단별 승인대사 호출 시, 가맹점관리자 내 데이터 항목설정이 되어있어야 합니다.
- 접속시간은 정해진 1시간 범위 내로 접속할 수 있으며, 횟수에 대한 제한은 없습니다.
- 조회 가능 일자는 하루치 대사데이터만 조회 가능합니다.
- 각 항목의 구분자는 "|"(파이프) 로 구분됩니다.
승인대사 요청정보
범용(공통) URL : https://iniweb.inicis.com/service/urlsvc/UrlSendAll.jsp
- 범용(공통) URL 은 신용카드, 계좌이체, 가상계좌, 휴대폰, 전화결제, 문화상품권 중 사용중인 지불수단에 한해 제공합니다.
- 범용(공통) URL 호출 시, 지불수단에 따라 조회 항목이 상이한 관계로 아래와 같이 고정값으로 전송됩니다.
- 지불수단 | MID | TID | 주문번호 | 승인일자 | 취소일자 | 거래금액 | 거래상태 | 제휴할인금액 | 제휴할인명 - 범용(공통) URL 은 GID 사용이 불가합니다.
| urlid* | 가맹점 IP 등록 시 등록된 아이디 ( MID 또는 GID ) 등록된 정보는 영업담당자 문의 |
10 byte
|
|---|---|---|
| passwd* | 가맹점 IP 등록 시 등록된 패스워드 등록된 정보는 영업담당자 문의 |
N/A
|
| date* | 조회하고자 하는 날짜 [YYYYMMDD] |
8 byte
|
| stime* | 조회시작시간 ["000000" 고정] |
6 byte
|
| etime* | 조회종료시간 ["235959" 고정] |
6 byte
|
| gmid | GID 여부 urlid 가 GID인 경우 "1" 세팅 (GID 이용 시 범용조회 미적용) urlid 가 MID인 경우 해당 파라미터 삭제 |
1 byte
|
STEP2승인대사 응답
※ 유의사항
- 승인대사 응답 파라미터는 가맹점관리자에서 설정한 데이터 항목에 따라 응답됩니다.
- 범용(공통) URL 로 승인대사 조회 시, 아래 항목이 고정값으로 응답됩니다.
| 지불수단 | 지불수단(한글표기) 신용카드, ISP, 실시간계좌이체, 가상계좌, 핸드폰, 해피머니상품권, 문화상품권, 틴캐쉬, 스마트문상, 도서문화상품권, 이니렌탈, 알리페이, 텐페이/위챗, 제로페이, CBT |
String(14)
|
|---|---|---|
| MID | 상점아이디 |
String(10)
|
| TID | 거래번호 |
String(40)
|
| 주문번호 | 상점주문번호 |
String(64)
|
| 승인일자 | 승인일자 [YYYYMMDD] |
String(8)
|
| 취소일자 | 취소일자 [YYYYMMDD] |
String(8)
|
| 거래금액 | 거래금액 |
Number(22)
|
| 컵보증금 | 컵보증금 지불수단별 신용카드 승인대사에서 설정 가능 |
Number(22)
|
| 거래상태 | 거래상태(한글표기) - 지불수단별로 상이 신용카드 : 승인, 매입전취소, 매입후취소 / 휴대폰 : 승인, 환불, 취소 / 그 외 : 승인, 취소 |
String(10)
|
| 제휴할인금액 | 제휴할인금액 신용카드, ISP 만 전달 (이외 지불수단은 0 으로 표기) |
Number(22)
|
| 제휴할인명 | 제휴할인명 신용카드, ISP 만 전달 (이외 지불수단은 공백으로 표기) |
String(40)
|
ERROR승인대사 에러코드
| 0001 | 가맹점 서버 IP 등록되지 않았을때 발생되는 오류 ▶ 계약 담당자에게 IP 등록요청 필요 |
|---|---|
| 0002 | 대사 데이터 내역이 없을 때 발생되는 오류 ▶ 조회 일자에 거래내역이 존재하는지 확인 필요 |
| 0003 | 가맹점관리자 사이트에서 데이터항목설정을 하지 않았을 때 발생되는 오류 ▶ 가맹점관리자 사이트 접속하여 다운로드 항목 설정 필요 |