빌키 발급받기

Last updated 1 year ago

빌링키란?

빌링키는고객의 카드번호, 유효기간, 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

빌링키란?

빌링키는 고객 정보와 함께 서버에 저장하세요. 한 번 발급받은 빌링키는 다시 조회할 수 없습니다.

빌키 발급 파라미터

빌키 요청

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