상단으로 이동

KG이니시스

KG이니시스

폼 페이 ※ 별도 계약필요(영업담당자 문의)

KG 이니시스 결제창을 호출하지 않고 Form 전문 통신으로 거래를 진행하기 위한 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/v2/pg/formpay/vacct
  • Header 정보
    POST /v2/pg/formpay/vacct HTTP/1.1
    Host: iniapi.inicis.com
    Content-type: application/json
mid* String 상점아이디
10 byte
type* String 요청서비스 ["formpay" 고정]
6 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 상세
moid* String 주문번호
40 byte
goodName* String 상품명
80 byte
price* String 결제금액
10 byte
buyerName* String 구매자명
80 byte
buyerEmail* String 구매자 이메일주소
"@", "." 외 특수문자 입력불가
60 byte
buyerTel* String 구매자 휴대폰번호
40 byte
bankCode* String 은행코드
은행코드
2 byte
dtInput* String 입금예정일자 [YYYYMMDD]
8 byte
tmInput* String 입금예정시간 [hhmm]
4 byte
nmInput* String 입금자명
20 byte
url* String 가맹점 URL
50 byte
currency* String 통화코드 [WON,USD]
3 byte
vacctType String 타입 ["3" 과오납체크]
과오납체크 요청 시에만 세팅 (별도계약)
1 byte
vacct String 벌크 가상계좌번호
16 byte
flgCash String 현금영수증 발행여부 ["0":미발행, "1":소득공제 발행, "2":지출증빙]
1 byte
cashRegNo String 현금영수증 발행정보 (주민등록번호, 휴대폰번호, 사업장등록번호 등)
ENC
20 byte

STEP2가상계좌 채번응답

※ 유의사항

해당 응답파라미터는 모든 프로세스 종료 후 최종적으로 전달되는 결과값 입니다.

  1. 응답파라미터는 추후 요건에 의해 추가될 수 있습니다.
  2. 실패 응답 시, 일부 파라미터 응답이 null 일 수 있습니다.
  3. 응답형식은  JSON 형식  입니다.
  4. 요청형식 에 따라 응답파라미터가 상이합니다.
resultCode 결과코드
"00":성공, 이외 실패
6 byte
resultMsg 결과메세지
100 byte
authDate 채번일자 [YYYYMMDD]
8 byte
authTime 채번시간 [hhmmss]
6 byte
tid 가상계좌 채번 거래번호
40 byte
vacct 가상계좌번호
입금통보
14 byte
price 결제금액
12 byte
inputName 입금자명
N/A
vacctName 예금주명
N/A
bankCode 가상계좌 발급은행코드
2 byte
validDate 가상계좌 입금기한일자
8 byte
validTime 가상계좌 입금기한시간
6 byte

LOCK신용카드 결제요청

신용카드 폼 페이결제

KG이니시스 결제창을 호출하지 않고 Form 전송방식으로 신용카드 결제를 하기 위한 API 입니다.

  • 폼 페이 API 는 영업담당자를 통해 별도 계약 후 사용가능합니다.
  • 매뉴얼 열람을 위해서는 폼 페이 사용 계약된 가맹점의 MID 로 로그인 해야합니다.
    (계약여부는 영업담당자 또는 1588-4954 고객센터로 문의부탁드립니다.)
  • KG이니시스의 테스트용 MID 로는 매뉴얼 열람이 불가합니다.

LOCK신용카드 결제응답

신용카드 폼 페이결제

KG이니시스 결제창을 호출하지 않고 Form 전송방식으로 신용카드 결제를 하기 위한 API 입니다.

  • 폼 페이 API 는 영업담당자를 통해 별도 계약 후 사용가능합니다.
  • 매뉴얼 열람을 위해서는 폼 페이 사용 계약된 가맹점의 MID 로 로그인 해야합니다.
    (계약여부는 영업담당자 또는 1588-4954 고객센터로 문의부탁드립니다.)
  • KG이니시스의 테스트용 MID 로는 매뉴얼 열람이 불가합니다.

LOCK빌링키 발급요청

신용카드 폼 페이 빌링키발급

KG이니시스 결제창을 호출하지 않고 Form 전송방식으로 신용카드 billkey 를 발급하기 위한 API 입니다.

  • 폼 페이 API 는 영업담당자를 통해 별도 계약 후 사용가능합니다.
  • 매뉴얼 열람을 위해서는 폼 페이 사용 계약된 가맹점의 MID 로 로그인 해야합니다.
    (계약여부는 영업담당자 또는 1588-4954 고객센터로 문의부탁드립니다.)
  • KG이니시스의 테스트용 MID 로는 매뉴얼 열람이 불가합니다.

LOCK빌링키 발급응답

신용카드 폼 페이 빌링키발급

KG이니시스 결제창을 호출하지 않고 Form 전송방식으로 신용카드 billkey 를 발급하기 위한 API 입니다.

  • 폼 페이 API 는 영업담당자를 통해 별도 계약 후 사용가능합니다.
  • 매뉴얼 열람을 위해서는 폼 페이 사용 계약된 가맹점의 MID 로 로그인 해야합니다.
    (계약여부는 영업담당자 또는 1588-4954 고객센터로 문의부탁드립니다.)
  • KG이니시스의 테스트용 MID 로는 매뉴얼 열람이 불가합니다.