빌키 발급받기
빌링키는 결제수단을 관리하는 곳에서 발급합니다.
빌링키란?
빌링키는고객의 카드번호, 유효기간, CVC 등 결제 정보를 암호화한 값으로 생각할 수 있습니. 본인인증을 마치고 한 번 빌링키를 발급받으면, 고객의 의사와 무관하게 빌링키로 계속 결제가 가능합니다.. 악용되지 않게 반드시 고객 본인인증을 받은 뒤에 빌링키를 발급받는 것을 추천합니다.
빌링키는 고객 정보와 함께 서버에 저장하세요. 한 번 발급받은 빌링키는 다시 조회할 수 없습니다.
빌키 발급 파라미터
빌키 요청
URL : /payment/bill/regist Protocol : HTTP/1.1 Method : POST Encoding : UTF-8 Content-Type : application/json
method
결제수단 CARD(신용카드)
mId(10byte)
상점 아이디
orderId(40byte)
주문 번호 주문한 결제를 식별하는 역할로, 결제를 요청할 때 가맹점에서 만들어서 사용한 값입니다. 중복되지 않는 고유한 값을 발급해야 합니다.
orderName(100byte)
상품명
amount(15byte)
거래 금액
customerName(30byte)
구매자명
cpCd(4byte)
카드사 코드 카드사 코드 바로가기
cardTypeCd(2byte)
카드 타입 코드 데이터 없으면 공백 리턴 01 : 개인 02 : 법인
cardNo(20byte)
카드 번호
cardExpirationYear(2byte)
카드 유효연도 예시) yy(24)
cardExpirationMonth(2byte)
카드 유효 월 예시) mm(03)
ediDate(14byte)
인증처리 일시 형태 : YYYYMMDDHHmmss 예시) 20230914135133
hashString(256byte)
결제정보 검증 데이터 (mId + ediDate + amount + 가맹점KEY) 인증 데이터 정합성을 위해 가맹점에서 HASH값 비교
ordIp(20byte)
구매자 아이피 유저 접속 아이피(IPv4, IPv6 지원)
customerMobilePhone(20byte)
구매자 연락처
customerEmail(60byte)
구매자 이메일 주소
mbsReserved(500byte)
상점 예약 필드에 셋팅한 값
ordAuthNo(10byte)
카드인증번호 생년월일 6자리(사업자번호) 형태 : yymmdd (계약에 따라 필수 여부 다름)
cardPw(4byte)
카드비밀번호 카드 비밀번호 앞 2자리(계약에 따라 필수 여부 다름)
빌키 응답
resultCd(4byte)
인증에 대한 성공, 실패 코드
: 0000
: 0000을 제외한 나머지
resultMsg(100byte)
결과 메시지
: 정상처리
: 기타 오류 메시지
bid(30byte)
빌키 아이디
tid(30byte)
인증 거래번호
mId(21byte)
상점 아이디
method(2byte)
지불수단 (결제방식) 01 : 카드결제 02 : 실시간 계좌이체 03 : 가상계좌 (무통장 입금)
spmCd(2byte)
결제 수단 Sub 코드 01 : 고정
ediDate(14byte)
인증 처리 일시 형태 : YYYYMMDDHHmmss 예시) 20230914135133
orderId(40byte)
주문 번호 주문한 결제를 식별하는 역할로, 결제를 요청할 때 가맹점에서 만들어서 사용한 값입니다. 중복되지 않는 고유한 값을 발급해야 합니다.
mbsReserved(500byte)
상점 예약 필드에 셋팅한 값
trDt(8byte)
결제일 형태 : yyyyMMdd 예시) 20230914
trTm(6byte)
결제 시간 형태 : HHmmss 예시) 164934
Last updated