현금영수증
KG 이니시스를 통해 현금영수증을 별도발행하기 위한 API 서비스
Quick Guide
샘플 다운로드
개발 언어에 맞는 샘플을
다운로드 받아 주세요.
테스트 실행 및 결과확인
결제 진행과정과
응답결과를 확인해 주세요.
실제 연동진행
가맹점 실서버 환경에 맞게
연동을 진행해주세요.
연동 준비하기
현금영수증 API 연동 전, 체크해야할 사항을 안내드립니다.
MID상점아이디
계약 완료 여부, 사용 가능 지불 수단 등은 계약담당자 문의INIAPI key대칭키
가맹점관리자 ▶ 상점정보 ▶ 계약정보 ▶ 부가정보 ▶ INIAPI key 생성조회방화벽정보
항목 | 스테이징환경 | 운영환경 |
---|---|---|
URL | stginiapi.inicis.com | iniapi.inicis.com |
IP | 118.129.210.153 | 118.129.210.166 183.109.71.79 |
PORT | 443 | |
연결방향 | OUTBOUND | |
프로토콜 | TLS 1.2 이상 지원 |
STEP1현금영수증 (별도)발행요청
현금영수증 발행정보
- 요청전문 형식 : JSON NVP
- 현금영수증 URL : https://iniapi.inicis.com/api/v1/receipt
- Header 정보
POST /api/v1/receipt HTTP/1.1
Host: iniapi.inicis.com
Content-type: application/x-www-form-urlencoded;charset=utf-8
- 유의사항
각 파라미터는 key=value 로 세팅하여 POST 로 API 요청 ( JSON방식 요청불가 )
Form data 세팅 후 API 통신 구간에서 모든 value를 urlEncode 하여 전송
type* | 요청서비스 ["Issue" 고정] |
7 byte
|
---|---|---|
paymethod* | 지불수단 코드 ["Receipt" 고정] |
10 byte
|
timestamp* | 전문생성시간 [YYYYMMDDhhmmss] |
14 byte
|
clientIp* | 가맹점 요청 서버IP (추후 거래 확인 등에 사용됨) |
15 byte
|
mid* | 상점아이디 |
10 byte
|
crPrice* | 결제금액 |
10 byte
|
supPrice* | 공급가액 |
10 byte
|
tax* | 부가세 |
10 byte
|
srcvPrice* | 봉사료 |
10 byte
|
goodName* | 상품명 |
80 byte
|
buyerName* | 구매자명 |
80 byte
|
buyerEmail* | 구매자 이메일주소 "@", "." 외 특수문자 입력불가 |
60 byte
|
buyerTel | 구매자 휴대폰번호 |
40 byte
|
currency | 통화코드 [WON,USD] |
3 byte
|
regNum* | 현금영수증 식별번호 (주민번호,휴대폰번호,사업자번호) |
ENC
18 byte
|
useOpt* | 현금영수증 발행용도 ["0":소득공제, "1":지출증빙] |
1 byte
|
compayNumber | 서브몰 사업자번호 서브몰 등록 요청 후 사용 가능 |
1 byte
|
hashData* | SHA512 HASH 한 값 대상 : INIAPIKey + type + paymethod + timestamp + clientIp + mid + crPrice + supPrice + srcvPrice + regNum |
HASH
128 byte
|
현금영수증 발행정보
- 요청전문 형식 : JSON NVP
- 현금영수증 URL : https://iniapi.inicis.com/v2/pg/receipt
- Header 정보
POST /v2/pg/receipt HTTP/1.1
Host: iniapi.inicis.com
Content-type: application/json
mid* | String | 상점아이디 |
10 byte
|
---|---|---|---|
type* | String | 요청서비스 ["receipt" 고정] |
7 byte
|
timestamp* | String | 전문생성시간 [YYYYMMDDhhmmss] |
14 byte
|
clientIp* | String | 가맹점 요청 서버IP (추후 거래 확인 등에 사용됨) |
15 byte
|
hashData* | String | SHA512 HASH 한 값 대상 : INIAPIKey + mid + type + timestamp + data |
HASH
128 byte
|
data* | Data | 요청데이터 |
N/A
|
Data 상세 | |||
price* | String | 결제금액 |
10 byte
|
supplyPrice* | String | 공급가액 |
10 byte
|
tax* | String | 부가세 |
10 byte
|
servicePrice* | String | 봉사료 |
10 byte
|
issueType* | String | 현금영수증 발행용도 ["0":소득공제, "1":지출증빙] |
1 byte
|
issueNumber* | String | 현금영수증 식별번호 (주민번호,휴대폰번호,사업자번호) |
ENC
18 byte
|
goodName* | String | 상품명 |
80 byte
|
buyerName* | String | 구매자명 |
80 byte
|
buyerEmail* | String | 구매자 이메일주소 "@", "." 외 특수문자 입력불가 |
60 byte
|
buyerTel | String | 구매자 휴대폰번호 |
40 byte
|
currency | String | 통화코드 [WON,USD] |
3 byte
|
compayNumber | String | 서브몰 사업자번호 서브몰 등록 요청 후 사용 가능 |
1 byte
|
STEP2현금영수증 (별도)발행응답
※ 유의사항
해당 응답파라미터는 모든 프로세스 종료 후 최종적으로 전달되는 결과값 입니다.
- 응답파라미터는 추후 요건에 의해 추가될 수 있습니다.
- 실패 응답 시, 일부 파라미터 응답이 null 일 수 있습니다.
- 응답형식은 JSON 형식 입니다.
- 요청형식 에 따라 응답파라미터가 상이합니다.
resultCode | 결과코드 "00":성공, 이외 실패 |
6 byte
|
---|---|---|
resultMsg | 결과메세지 |
100 byte
|
authDate | 발급일자 [YYYYMMDD] |
8 byte
|
authTime | 발급시간 [hhmmss] |
6 byte
|
tid | 현금영수증발급 거래번호 |
40 byte
|
authCode | 현금영수증 발급결과코드 |
40 byte
|
authNo authNumber | 현금영수증 승인번호 |
N/A
|
authPrice | 현금영수증 발급금액 |
6 byte
|
authSupplyPrice | 공급가액 |
10 byte
|
authTax | 부가세 |
10 byte
|
authSrvcPrice authServicePrice | 봉사료 |
10 byte
|
authUseOpt authissueType | 현금영수증 발행구분 ["0":소득공제, "1":지출증빙] |
1 byte
|