포인트
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 이상 지원 | |
STEP1OCB적립 요청
OCB적립 요청정보
- OCB적립 URL : https://iniapi.inicis.com/api/v1/point
- Header 정보
POST /api/v1/point 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* | 요청서비스 ["Point" 고정] |
7 byte
|
|---|---|---|
| paymethod* | 지불수단 코드 ["OCBPoint" 고정] |
10 byte
|
| timestamp* | 전문생성시간 [YYYYMMDDhhmmss] |
14 byte
|
| clientIp* | 가맹점 요청 서버IP (추후 거래 확인 등에 사용됨) |
15 byte
|
| mid* | 상점아이디 |
10 byte
|
| price* | 결제금액 |
10 byte
|
| savePrice* | 적립금액 |
10 byte
|
| payOption* | OCB구분
[OCBpay, OCBplus, OCBpayonly, OCBboth] OCBplus 경우만 필수 |
10 byte
|
| ocbNum* | OCB 카드번호 |
ENC
16 byte
|
| url* | 가맹점 URL |
50 byte
|
| goodName* | 상품명 |
80 byte
|
| buyerName* | 구매자명 |
80 byte
|
| buyerEmail* | 구매자 이메일주소 "@", "." 외 특수문자 입력불가 |
60 byte
|
| buyerTel* | 구매자 휴대폰번호 |
40 byte
|
| currency* | 통화코드 [WON,USD] |
3 byte
|
| hashData* | SHA512 HASH 한 값 대상 : INIAPIKey + type + paymethod + timestamp + clientIp + mid + price + savePrice + ocbNum |
HASH
128 byte
|
STEP2OCB적립 응답
※ 유의사항
해당 응답파라미터는 모든 프로세스 종료 후 최종적으로 전달되는 결과값 입니다.
- 응답파라미터는 추후 요건에 의해 추가될 수 있습니다.
- 실패 응답 시, 일부 파라미터 응답이 null 일 수 있습니다.
- 응답형식은 JSON 형식 입니다.
| resultCode | 결과코드 "00":성공, 이외 실패 |
6 byte
|
|---|---|---|
| resultMsg | 결과메세지 |
100 byte
|
| tid | OCB 적립 거래번호 |
40 byte
|
| paymethod | 지불수단 [OCB Point] |
10 byte
|
| confirmSavePrice | OCB적립 금액 |
10 byte
|
| confirmSavePoint | OCB적립 포인트 |
10 byte
|