승인 대사
KG이니시스를 통해 승인(취소)된 데이터와 가맹점에서 자체 관리되는 데이터 일치여부 확인을 위한 거래데이터 조회 서비스
Quick Guide
서비스 신청
1588-4954(고객센터)
또는 영업담당자를 통해
대사서비스를 신청해주세요.
가맹점 IP 등록
영업담당자를 통해 가맹점의
공인서버 IP 를 등록해주세요.
수신데이터 항목(고정)
승인대사에서 응답되는
데이터 항목을 확인해주세요.
파라미터 세팅 후 URL 호출
가맹점 실서버 환경에 맞게
연동을 진행해주세요.
STEP1승인대사 조회
※ 유의사항
- 접속시간은 정해진 1시간 범위 내로 접속할 수 있으며, 횟수에 대한 제한은 없습니다.
- 조회 가능 일자는 하루치 대사데이터만 조회 가능합니다.
- 각 항목의 구분자는 "|"(파이프) 로 구분됩니다.
승인대사 요청정보
대사요청 URL : https://iniweb.inicis.com/service/urlsvc/UrlSendCBT.jsp
| urlid* | 가맹점 IP 등록 시 등록된 아이디 ( MID 또는 GID ) 등록된 정보는 영업담당자 문의 |
10 byte
|
|---|---|---|
| passwd* | 가맹점 IP 등록 시 등록된 패스워드 등록된 정보는 영업담당자 문의 |
20 byte
|
| date* | 조회하고자 하는 날짜 [YYYYMMDD] |
8 byte
|
| stime* | 조회시작시간 ["000000" 고정] |
6 byte
|
| etime* | 조회종료시간 ["235959" 고정] |
6 byte
|
| gmid | GID 여부 urlid 가 GID인 경우 "1" 세팅 urlid 가 MID인 경우 "0" 새탕 ( 미 입력 시, 자동 "0" 세팅) |
1 byte
|
| paymtd* | 지불수단 CBT-GMO(SBPS) 인 경우 "1" 세팅 CBT-BOKU 인 경우 "2" 세팅 |
1 byte
|
| sttm | 정산 관련 컬럼 조회 여부 "1" 세팅 시, 거래건에 대한 수수료, 부가세 확인 |
1 byte
|
STEP2승인대사 응답
※ 유의사항
- 승인대사 응답 파라미터는 16 개의 항목이 고정 값으로 응답 됩니다.
- sttm 파라미터 여부에 따라서 4 개의 추가 필드 응답이 가능합니다.
| 지불수단 | 지불수단 CBT-GMO , CBT-BOKU , CBT-SBPS |
String(8)
|
|---|---|---|
| MID | 상점아이디 |
String(10)
|
| TID | 거래번호 |
String(40)
|
| 주문번호 | 상점주문번호 |
String(100)
|
| 승인일시 | 승인일시 YYYYMMDDHH24MISS |
String(14)
|
| 취소일시 | 취소일시 YYYYMMDDHH24MISS |
String(14)
|
| 구매자명 | 구매자명 |
String(100)
|
| 구매상품명 | 구매상품명 |
String(100)
|
| 상품금액 | 상품금액 |
N/A
|
| 거래화폐코드 | 거래화폐코드 JPY, WON, USD, KRW |
String(3)
|
| 거래상태 | 거래상태 승인, 전체취소, 부분취소, 망상취소 |
String(10)
|
| 결제수단 | 결제수단 신용카드(V/M), 신용카드(J/A), 신용카드(D), 편의점결제(CVS) 계좌이체(Payeasy), 라인페이(LINEpay), 페이페이(Paypay) 메르페이(Merpay), 아마존페이(AmazonPay), 라쿠텐페이(RakutenPay) |
String(14)
|
| 카드 할부개월 수 | 카드 할부개월 수 |
String(2)
|
| SID | SID |
N/A
|
| 편의점 구분 | 편의점 구분 세븐일레븐, 패밀리마트, 미니스톱, 세이코마트, 로손 |
String(100)
|
| 거래 승인번호 | 거래 승인번호 |
String(50)
|
| 예정 수수료 | 예정 수수료 파라미터 sttm이 1 세팅 시, 전달 |
N/A
|
| 예정 부가세 | 예정 부가세 파라미터 sttm이 1 세팅 시, 전달 |
N/A
|
| 지급 예정금액 | 지급 예정금액 파라미터 sttm이 1 세팅 시, 전달 |
N/A
|
| 정산통화 | 정산통화 파라미터 sttm이 1 세팅 시, 전달 JPY, WON, USD, KRW |
String(3)
|