> For the complete documentation index, see [llms.txt](https://developer.seedpayments.co.kr/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.seedpayments.co.kr/docs/sdk/api/billing/regist.md).

# 빌키 발급받기

빌링키는 결제수단을 관리하는 곳에서 발급합니다.

***

## 빌링키란?

빌링키는고객의 카드번호, 유효기간, CVC 등 결제 정보를 암호화한 값으로 생각할 수 있습니. 본인인증을 마치고 한 번 빌링키를 발급받으면, 고객의 의사와 무관하게 빌링키로 계속 결제가 가능합니다.. 악용되지 않게 반드시 고객 본인인증을 받은 뒤에 빌링키를 발급받는 것을 추천합니다.

{% hint style="danger" %}
빌링키는 고객 정보와 함께 서버에 저장하세요. 한 번 발급받은 빌링키는 다시 조회할 수 없습니다.
{% endhint %}

## 빌키 발급 파라미터

<details>

<summary>빌키 요청</summary>

**URL :** /payment/bill/regist\
**Protocol :** HTTP/1.1\
**Method :** POST\
**Encoding :** UTF-8\
**Content-Type :** application/json

***

**method**<img src="/files/81VXGsoyuPARausLk0YK" alt="" data-size="line"><img src="/files/nTFfdOOuksU5rrXWNE0e" alt="" data-size="line">

결제수단\
CARD(신용카드)

***

**mId**<img src="/files/81VXGsoyuPARausLk0YK" alt="" data-size="line"><img src="/files/nTFfdOOuksU5rrXWNE0e" alt="" data-size="line">(10byte)

상점 아이디

***

**orderId**<img src="/files/81VXGsoyuPARausLk0YK" alt="" data-size="line"><img src="/files/nTFfdOOuksU5rrXWNE0e" alt="" data-size="line">(40byte)

주문 번호\
주문한 결제를 식별하는 역할로, 결제를 요청할 때 가맹점에서 만들어서 사용한 값입니다.\
중복되지 않는 고유한 값을 발급해야 합니다.

***

**orderName**<img src="/files/81VXGsoyuPARausLk0YK" alt="" data-size="line"><img src="/files/nTFfdOOuksU5rrXWNE0e" alt="" data-size="line">(100byte)

상품명

***

**amount**<img src="/files/81VXGsoyuPARausLk0YK" alt="" data-size="line"><img src="/files/nTFfdOOuksU5rrXWNE0e" alt="" data-size="line">(15byte)

거래 금액

***

**customerName**<img src="/files/81VXGsoyuPARausLk0YK" alt="" data-size="line"><img src="/files/nTFfdOOuksU5rrXWNE0e" alt="" data-size="line">(30byte)

구매자명

***

**cpCd**<img src="/files/81VXGsoyuPARausLk0YK" alt="" data-size="line"><img src="/files/nTFfdOOuksU5rrXWNE0e" alt="" data-size="line">(4byte)

카드사 코드\
[카드사 코드 바로가기](/docs/pay_code/manual-code-partner.md#undefined-1)

***

**cardTypeCd**<img src="/files/81VXGsoyuPARausLk0YK" alt="" data-size="line"><img src="/files/nTFfdOOuksU5rrXWNE0e" alt="" data-size="line">(2byte)

카드 타입 코드\
데이터 없으면 공백 리턴\
01 : 개인\
02 : 법인

***

**cardNo**<img src="/files/81VXGsoyuPARausLk0YK" alt="" data-size="line"><img src="/files/nTFfdOOuksU5rrXWNE0e" alt="" data-size="line">(20byte)

카드 번호

***

**cardExpirationYear**<img src="/files/81VXGsoyuPARausLk0YK" alt="" data-size="line"><img src="/files/nTFfdOOuksU5rrXWNE0e" alt="" data-size="line">(2byte)

카드 유효연도\
예시) yy(24)

***

**cardExpirationMonth**<img src="/files/81VXGsoyuPARausLk0YK" alt="" data-size="line"><img src="/files/nTFfdOOuksU5rrXWNE0e" alt="" data-size="line">(2byte)

카드 유효 월\
예시) mm(03)

***

**ediDate**<img src="/files/81VXGsoyuPARausLk0YK" alt="" data-size="line"><img src="/files/nTFfdOOuksU5rrXWNE0e" alt="" data-size="line">(14byte)

인증처리 일시\
형태 : YYYYMMDDHHmmss\
예시) 20230914135133

***

**hashString**<img src="/files/81VXGsoyuPARausLk0YK" alt="" data-size="line"><img src="/files/nTFfdOOuksU5rrXWNE0e" alt="" data-size="line">(256byte)

결제정보 검증 데이터 (mId + ediDate + amount + 가맹점KEY)\
인증 데이터 정합성을 위해 가맹점에서 HASH값 비교

***

**ordIp**<img src="/files/nTFfdOOuksU5rrXWNE0e" alt="" data-size="line">(20byte)

구매자 아이피\
유저 접속 아이피(IPv4, IPv6 지원)

***

**customerMobilePhone**<img src="/files/nTFfdOOuksU5rrXWNE0e" alt="" data-size="line">(20byte)

구매자 연락처

***

**customerEmail**<img src="/files/nTFfdOOuksU5rrXWNE0e" alt="" data-size="line">(60byte)

구매자 이메일 주소

***

**mbsReserved**<img src="/files/nTFfdOOuksU5rrXWNE0e" alt="" data-size="line">(500byte)

상점 예약 필드에 셋팅한 값

***

**ordAuthNo**<img src="/files/nTFfdOOuksU5rrXWNE0e" alt="" data-size="line">(10byte)

카드인증번호\
생년월일 6자리(사업자번호) 형태 : yymmdd\
(계약에 따라 필수 여부 다름)

***

**cardPw**<img src="/files/nTFfdOOuksU5rrXWNE0e" alt="" data-size="line">(4byte)

카드비밀번호\
카드 비밀번호 앞 2자리(계약에 따라 필수 여부 다름)

</details>

<details>

<summary>빌키 <strong>응답</strong></summary>

**resultCd**<img src="/files/nTFfdOOuksU5rrXWNE0e" alt="" data-size="line">(4byte)

인증에 대한 성공, 실패 코드\ <img src="/files/CeiFvOGoXEJdaHt85NMF" alt="" data-size="line"> : 0000\ <img src="/files/R6CfddlvqWKSraY8xVcT" alt="" data-size="line"> : 0000을 제외한 나머지

***

**resultMsg**<img src="/files/nTFfdOOuksU5rrXWNE0e" alt="" data-size="line">(100byte)

결과 메시지\ <img src="/files/CeiFvOGoXEJdaHt85NMF" alt="" data-size="line"> : 정상처리\ <img src="/files/R6CfddlvqWKSraY8xVcT" alt="" data-size="line"> : 기타 오류 메시지

***

**bid**<img src="/files/nTFfdOOuksU5rrXWNE0e" alt="" data-size="line">(30byte)

빌키 아이디

***

**tid**<img src="/files/nTFfdOOuksU5rrXWNE0e" alt="" data-size="line">(30byte)

인증 거래번호

***

**mId**<img src="/files/nTFfdOOuksU5rrXWNE0e" alt="" data-size="line">(21byte)

상점 아이디

***

**method**<img src="/files/nTFfdOOuksU5rrXWNE0e" alt="" data-size="line">(2byte)

지불수단 (결제방식)\
01 : 카드결제\
02 : 실시간 계좌이체\
03 : 가상계좌 (무통장 입금)

***

**spmCd**<img src="/files/nTFfdOOuksU5rrXWNE0e" alt="" data-size="line">(2byte)

결제 수단 Sub 코드\
01 : 고정

***

**ediDate**<img src="/files/nTFfdOOuksU5rrXWNE0e" alt="" data-size="line">(14byte)

인증 처리 일시\
형태 : YYYYMMDDHHmmss\
예시) 20230914135133

***

**orderId**<img src="/files/nTFfdOOuksU5rrXWNE0e" alt="" data-size="line">(40byte)

주문 번호\
주문한 결제를 식별하는 역할로, 결제를 요청할 때 가맹점에서 만들어서 사용한 값입니다.\
중복되지 않는 고유한 값을 발급해야 합니다.

***

**mbsReserved**<img src="/files/nTFfdOOuksU5rrXWNE0e" alt="" data-size="line">(500byte)

상점 예약 필드에 셋팅한 값

***

**trDt**<img src="/files/nTFfdOOuksU5rrXWNE0e" alt="" data-size="line">(8byte)

결제일\
형태 : yyyyMMdd\
예시) 20230914

***

**trTm**<img src="/files/nTFfdOOuksU5rrXWNE0e" alt="" data-size="line">(6byte)

결제 시간\
형태 : HHmmss\
예시) 164934

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developer.seedpayments.co.kr/docs/sdk/api/billing/regist.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.