---
title: "빌링키 발급 API"
method: POST
path: "/subscribe/customers/{customer_uid}"
tags: ["subscribe.customer"]
---

# 빌링키 발급 API

`POST /subscribe/customers/{customer_uid}`

구매자에 대해 빌링키 발급 및 저장 <br> 해당 빌링키 발급 API는 PG사와 협의가 완료된 경우 이용 가능한 서비스입니다.
                        <ul> <li>PG사 협의를 통해 카드정보 필수 조건 값 조정이 가능합니다.</li>
                        <li>민감한 카드정보를 이용하기 때문에 보안에 특히 유의하셔야 합니다.</li>
                        <li>customer_uid 값은 <b>고객 & 카드번호</b> 단위별로 고유하게 발급 관리되어야 합니다</li>
                        </ul>

## Path parameters

- `customer_uid` string, required

## Response `200`

정상 등록 시, 일반 빌링키 발급은 CustomerResponse를 반환하며, channel_group_id를 이용한 슈퍼 빌링키 발급은 SuperBillingKeyResponse를 반환합니다.

- object
  - `CustomerResponse` CustomerResponse — unresolved $ref
  - `SuperBillingKeyResponse` SuperBillingKeyResponse — unresolved $ref

## Other responses

- `401` — 인증 Token이 전달되지 않았거나 유효하지 않은 경우

---

[API](https://skmtc.dev/iamport/apis/rest-api.md) · [All operations](https://skmtc.dev/iamport/apis/rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/iamport/rest-api/revisions/006dfffdec43/schema)