신용카드 빌키 발급 API
결제 하지 않고 빌키만 발급받는 API입니다. 발급받은 빌키는 2회차 이후 결제에 사용됩니다.
테스트용 키 정보
주의 사항
NOTE
빌키 서비스 신청 안내
빌키 서비스는 영업 담당자를 통해 별도 신청이 필요합니다.
- 빌키 발급 후 저장하여 2회차 결제시 사용합니다.
- 발급된 빌키는 빌키 결제 API에서 사용됩니다.
API 정보
POST/spay/APICardAuth.do
Content-Type
application/json테스트
https://tbgw.settlebank.co.kr/spay/APICardAuth.do운영
https://gw.settlebank.co.kr/spay/APICardAuth.do요청 파라미터
타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자예: AN(10) = 영문+숫자, 최대 10byte
params 객체
└mchtIdAN(12)영문+숫자, 최대 12byte*헥토파이낸셜에서 부여하는 고유 상점아이디
헥토파이낸셜에서 부여하는 고유 상점아이디
nxca_ks_gu: 구인증└verAN(4)영문+숫자, 최대 4byte*전문의 버전
전문의 버전
*고정값
└methodA(2)영문, 최대 2byte*결제수단
결제수단
*고정값
└bizTypeAN(2)영문+숫자, 최대 2byte*업무 구분코드
업무 구분코드
*고정값 (빌키 발급용)
└encCdN(2)숫자, 최대 2byte*암호화 구분 코드
암호화 구분 코드
*고정값
└mchtTrdNoAN(100)영문+숫자, 최대 100byte*상점에서 생성하는 고유한 주문번호
상점에서 생성하는 고유한 주문번호
└trdDtN(8)숫자, 최대 8byte*현재 전문을 전송하는 일자 (YYYYMMDD)
현재 전문을 전송하는 일자 (YYYYMMDD)
└trdTmN(6)숫자, 최대 6byte*현재 전문을 전송하는 시간 (HHMMSS)
현재 전문을 전송하는 시간 (HHMMSS)
└mobileYnA(1)영문, 최대 1byte모바일 여부
모바일 여부
Y: 모바일웹/앱 N: PC 또는 그 외└osTypeA(1)영문, 최대 1byteOS 구분
OS 구분
A: Android I: IOS W: Windows M: Mac E: 기타data 객체
└pktHashAN(64)영문+숫자, 최대 64byte*
SHA-256SHA256 방식으로 생성한 해쉬값(실시간 생성)SHA256 방식으로 생성한 해쉬값
NOTE
해쉬 생성 조합
trdDt + trdTm + mchtId + mchtTrdNo + "0" + hashKey
└cardNoN(128)숫자, 최대 128byte*
AES-256AES-256/ECB/PKCS5Padding + Base64카드번호, 숫자만카드번호, 숫자만
└idntNoN(64)숫자, 최대 64byte*
AES-256AES-256/ECB/PKCS5Padding + Base64생년월일 6자리 또는 사업자번호 10자리생년월일 6자리 또는 사업자번호 10자리
└vldDtMonN(24)숫자, 최대 24byte*
AES-256AES-256/ECB/PKCS5Padding + Base64카드 유효기간 (월), 숫자만카드 유효기간 (월), 숫자만
└vldDtYearN(24)숫자, 최대 24byte*
AES-256AES-256/ECB/PKCS5Padding + Base64카드 유효기간 (년), 숫자만카드 유효기간 (년), 숫자만
└cardPwdN(24)숫자, 최대 24byte*
AES-256AES-256/ECB/PKCS5Padding + Base64카드 비밀번호 앞 2자리카드 비밀번호 앞 2자리
└mchtCustNmAHN(30)영문+한글+숫자, 최대 30byte고객명 (한글 포함 가능)
고객명 (한글 포함 가능)
└mchtCustIdAHN(50)영문+한글+숫자, 최대 50byte고객아이디 (한글 포함 불가)
고객아이디 (한글 포함 불가)
└keyRegYnA(1)영문, 최대 1byte*인증 후 빌키 발급 여부
인증 후 빌키 발급 여부
Y: 빌키 발급 N: 빌키 발급 안함응답 파라미터
params 객체
└mchtIdAN(12)영문+숫자, 최대 12byte*헥토파이낸셜에서 부여하는 고유 상점아이디
nxca_ks_gu헥토파이낸셜에서 부여하는 고유 상점아이디
└verAN(4)영문+숫자, 최대 4byte*전문의 버전
0A19전문의 버전
*고정값
└methodA(2)영문, 최대 2byte*결제수단
CA결제수단
*고정값
└bizTypeAN(2)영문+숫자, 최대 2byte*업무 구분코드
A4업무 구분코드
*빌키 발급용 고정값
└encCdN(2)숫자, 최대 2byte*암호화 구분 코드
23암호화 구분 코드
*고정값
└mchtTrdNoAN(100)영문+숫자, 최대 100byte*상점에서 생성하는 고유한 주문번호
PG_API20220920131039상점에서 생성하는 고유한 주문번호
└trdNoAN(40)영문+숫자, 최대 40byte*헥토파이낸셜에서 생성하는 고유한 거래번호
STFP_PGCAnxca_ks_gu0220921093117M1260999헥토파이낸셜에서 생성하는 고유한 거래번호
└trdDtN(8)숫자, 최대 8byte*거래일자 (YYYYMMDD)
20220921거래일자 (YYYYMMDD)
└trdTmN(6)숫자, 최대 6byte*거래시간 (HHMMSS)
093117거래시간 (HHMMSS)
└outStatCdN(4)숫자, 최대 4byte*거래상태코드 (성공건 확인: 거래상태=0021 + 결과코드=0000)
0021거래상태코드 (성공건 확인: 거래상태=0021 + 결과코드=0000)
0021: 성공 0031: 실패└outRsltCdN(4)숫자, 최대 4byte*결과코드. 성공 0000, 그 외 거절코드
0000결과코드. 성공 0000, 그 외 거절코드
└outRsltMsgAHN(200)영문+한글+숫자, 최대 200byte*결과 메시지
정상처리되었습니다결과 메시지
data 객체
└pktHashAN(64)영문+숫자, 최대 64byte*요청시 hash 값 그대로 return
요청시 hash 값 그대로 return
└cardNoN(128)숫자, 최대 128byte카드번호 (마스킹)
522112******1621카드번호 (마스킹)
└issrIdA(64)영문, 최대 64byte카드발급사 식별자
HDC카드발급사 식별자
└cardNmAH(20)영문+한글, 최대 20byte카드사 명
현대카드사 명
└cardKindAN(50)영문+숫자, 최대 50byte카드 종류
현대마스타개인카드 종류
└billKeyAN(40)영문+숫자, 최대 40byte발급요청 Y일 때 빌키 응답. 2회차 결제시 사용.
SBILL_PGCAnxca_ks_gu20222609990921093117발급요청 Y일 때 빌키 응답. 2회차 결제시 사용.
*이 빌키를 저장하여 빌키 결제 API에서 사용합니다.
