> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 고객 포털

> 고객이 구독, 청구 내역, 라이센스 키 및 프로필을 안전하게 관리하고 셀프 서비스할 수 있도록 지원합니다.

<Info>
  고객 포털은 고객이 지원팀에 연락하지 않고도 구독을 관리하고, 청구서를 확인하며, 라이선스 키 세부 정보를 볼 수 있는 안전한 호스팅된 영역입니다.
</Info>

<CardGroup cols={2}>
  <Card title="Create Portal Session (API)" icon="code" href="/api-reference/customers/create-customer-portal-session">
    프로그래밍 방식으로 안전한 시간 제한 포털 세션을 생성합니다.
  </Card>

  <Card title="Subscriptions" icon="repeat" href="/features/subscription">
    정기 플랜, 업그레이드, 다운그레이드 및 추가 기능을 관리합니다.
  </Card>
</CardGroup>

<br />

<Frame>
  <img src="https://mintcdn.com/dodopayments/kCngKZVrb0rZMS1f/images/customer-portal/new-portal.png?fit=max&auto=format&n=kCngKZVrb0rZMS1f&q=85&s=9431b2e24142e47cb39dc84c1a0303fe" alt="활성 구독, 결제 수단, 청구 내역이 표시된 개편된 고객 포털" width="2876" height="1568" data-path="images/customer-portal/new-portal.png" />
</Frame>

## 고객 포털이란?

포털은 고객이 다음을 수행할 수 있는 신뢰할 수 있는 브랜드의 셀프 서비스 경험을 제공합니다:

* **청구 내역에 접근하기**: 청구서를 보고 영수증을 다운로드합니다.
* **구독 관리**: 구독 세부 정보를 보고, 즉시 또는 다음 청구일에 구독을 취소합니다.
* **결제 수단 업데이트**: 활성 구독의 결제 수단을 변경하거나 보류 중인 구독을 재활성화합니다.
* **라이선스 키 가져오기**: 구매와 연관된 모든 키에 접근합니다.
* **간편한 탐색**: 뒤로 가기 버튼을 사용하여 포털 섹션 간에 쉽게 이동할 수 있습니다.

## 주요 이점

* **지원 요청 감소**: 고객이 일반적인 청구 요청을 스스로 해결합니다.
* **가치 실현 속도 향상**: 청구서와 키에 즉시 접근합니다.
* **이탈 위험 감소**: 갱신 및 요금제 세부정보에 대한 명확한 가시성 제공
* **설계상 안전**: 만료되는 링크로 토큰화된 접근 제공

## 접근 방법

고객은 정적 링크 또는 일회성 동적 링크를 사용하여 포털에 접근할 수 있습니다.

### 정적 링크 (이메일 기반 접근)

고객은 만료되지 않는 정적 링크에 이메일을 입력하여 포털 접근을 요청할 수 있습니다.

정적 포털 링크 형식은 환경에 따라 다릅니다:

**테스트 모드** (테스트 및 개발용):

```bash theme={null}
https://test.customer.dodopayments.com/login/{business_id}
```

**실제 모드** (실제 거래용):

```bash theme={null}
https://customer.dodopayments.com/login/{business_id}
```

`{business_id}`을 실제 비즈니스 식별자로 교체한 다음 적절한 링크를 고객과 공유하여 이메일을 입력하고 포털에 안전하게 액세스할 수 있도록 합니다.

<Frame>
  <img src="https://mintcdn.com/dodopayments/kIuKVjhdOQFWlzSx/images/customer-portal/email-login.png?fit=max&auto=format&n=kIuKVjhdOQFWlzSx&q=85&s=bd8ee54177bc23e12e3657c87f487bae" alt="이메일 기반 로그인 화면" width="2880" height="1550" data-path="images/customer-portal/email-login.png" />
</Frame>

<Steps>
  <Step title="Merchant flow">
    1. Sales → Customer로 이동합니다.
    2. <i>Share invite</i>를 클릭합니다.
    3. <i>Static link</i>를 복사하여 고객에게 공유합니다.
  </Step>

  <Step title="Customer flow">
    1. 정적 링크를 엽니다.
    2. 구매에 사용한 이메일을 입력합니다.
    3. 포털에 액세스할 수 있는 안전한 로그인 링크를 받습니다.

    <Check>
      기존 고객은 자동으로 인식됩니다.
    </Check>
  </Step>
</Steps>

### 동적 링크 (매직 링크)

고객을 포털로 직접 보내는 개인화된 일회성 매직 링크입니다. 링크는 24시간 후에 만료됩니다.

<Warning>
  동적 링크는 24시간 후에 만료됩니다. 만료되면 새 링크를 생성하여 보내십시오.
</Warning>

<Frame>
  <img src="https://mintcdn.com/dodopayments/kIuKVjhdOQFWlzSx/images/customer-portal/magic-link.png?fit=max&auto=format&n=kIuKVjhdOQFWlzSx&q=85&s=8e63714f40468bd6e42c811e194f2698" alt="매직 링크 직접 액세스" width="2880" height="1554" data-path="images/customer-portal/magic-link.png" />
</Frame>

<Steps>
  <Step title="Merchant flow">
    1. 동적 링크를 엽니다.
    2. 고객에게 포털에 바로 액세스할 수 있도록 동적 링크를 공유합니다.
  </Step>

  <Step title="Customer flow">
    1. 동적 링크를 엽니다.
    2. 이메일을 입력하지 않고도 고객 포털에 바로 액세스합니다.
  </Step>
</Steps>

## 포털 기능

개편된 고객 포털은 왼쪽 사이드바와 계정 관리 요구 사항을 위한 정리된 섹션을 갖춘 깔끔하고 통합된 인터페이스를 제공합니다.

<CardGroup cols={2}>
  <Card title="Active Subscriptions" icon="repeat">
    모든 활성 구독을 플랜 이름, 가격, 갱신 날짜 및 유효성과 함께 확인할 수 있습니다. "Manage subscription"을 클릭하여 세부 정보를 보고 결제 정보를 편집하거나 취소합니다.
  </Card>

  <Card title="Payment Methods" icon="credit-card">
    저장된 모든 결제 수단(카드, UPI 등)을 한눈에 확인할 수 있습니다. 구독 세부 정보에서 직접 결제 수단을 편집할 수 있습니다.
  </Card>

  <Card title="Billing History" icon="file-invoice">
    날짜, 상태, 가격 유형, 권한 및 다운로드 가능한 청구서가 포함된 자세한 표에서 모든 거래를 확인합니다.
  </Card>

  <Card title="Billing Information" icon="user">
    구독 세부 정보 페이지에서 이름, 이메일, 전화번호 및 청구 주소를 확인하고 편집합니다.
  </Card>
</CardGroup>

### 포털 개요

메인 포털 페이지에는 모든 활성 구독, 저장된 결제 수단 및 청구 내역이 하나의 스크롤 가능한 뷰에 표시됩니다.

<Frame>
  <img src="https://mintcdn.com/dodopayments/kCngKZVrb0rZMS1f/images/customer-portal/new-portal.png?fit=max&auto=format&n=kCngKZVrb0rZMS1f&q=85&s=9431b2e24142e47cb39dc84c1a0303fe" alt="활성 구독과 결제 수단을 보여주는 고객 포털 메인 페이지" width="2876" height="1568" data-path="images/customer-portal/new-portal.png" />
</Frame>

### 결제 수단 및 청구 내역

아래로 스크롤하여 저장된 결제 수단과 상태 표시기 및 다운로드 가능한 청구서를 포함한 전체 청구 내역을 확인합니다.

<Frame>
  <img src="https://mintcdn.com/dodopayments/kCngKZVrb0rZMS1f/images/customer-portal/payment-methods-invoices.png?fit=max&auto=format&n=kCngKZVrb0rZMS1f&q=85&s=1aed6644dbb338cda755798eda99a6f2" alt="청구서 다운로드 기능이 있는 결제 수단 및 청구 내역" width="2880" height="1560" data-path="images/customer-portal/payment-methods-invoices.png" />
</Frame>

## 요금제 변경(업그레이드/다운그레이드)

제품이 **Product Collections**로 구성되어 있을 때 고객은 고객 포털에서 플랜 간 업그레이드 또는 다운그레이드를 직접 수행할 수 있습니다.

<Tip>
  **기존 구독에 대해 업그레이드/다운그레이드를 활성화하고 싶으신가요?** 구독 제품을 Product Collection에 추가하세요. 그룹화되면 고객은 고객 포털을 통해 동일한 컬렉션 내에서 플랜을 전환할 수 있습니다.
</Tip>

### 사용 가능한 작업

| 작업            | 설명                     | 사용 가능 조건                |
| ------------- | ---------------------- | ----------------------- |
| **Upgrade**   | 동일한 컬렉션의 상위 단계 플랜으로 이동 | 비즈니스에서 구독 업데이트를 활성화한 경우 |
| **Downgrade** | 동일한 컬렉션의 하위 단계 플랜으로 이동 | 비즈니스에서 구독 업데이트를 활성화한 경우 |

### 요금제 변경 작동 방식

1. 고객이 포털에서 현재 구독을 확인합니다.
2. 제품 컬렉션을 기반으로 이용 가능한 업그레이드/다운그레이드 옵션이 표시됩니다.
3. 고객이 새 플랜을 선택합니다.
4. 비례 계산이 수행되고 결제가 즉시 처리됩니다(해당되는 경우).
5. 구독이 새 플랜으로 업데이트됩니다.

<Info>
  요금제 변경은 동일한 컬렉션 내의 제품 간에서만 가능합니다. 제품은 구독 또는 사용량 기반 청구 유형이어야 합니다.
</Info>

### 비즈니스 제어

비즈니스는 구독 설정에서 요금제 변경 동작을 구성할 수 있습니다:

* **Allow Subscription Updates**: 고객이 구독을 업그레이드하거나 다운그레이드할 수 있는 기능을 활성화하거나 비활성화합니다

<Card title="Product Collections" icon="layer-group" href="/features/product-collections">
  제품 컬렉션을 설정하고 업그레이드/다운그레이드 경로를 구성하는 방법을 알아보세요.
</Card>

## 구독 세부 정보

고객이 활성 구독에서 "Manage subscription"을 클릭하면 구독 세부 정보 페이지로 이동합니다. 이 페이지는 다음을 보여줍니다:

* **Plan details**: 구독 이름, 가격, 갱신 날짜 및 유효 기간
* **Payment method**: 구독에 연결된 카드 또는 결제 수단과 "Edit" 버튼
* **Billing information**: 이름, 이메일, 전화번호 및 청구 주소와 "Edit" 버튼
* **Billing history**: 이 구독에 대한 모든 결제의 자세한 표
* **Cancel Subscription**: 구독을 취소하는 눈에 띄는 버튼

<Frame>
  <img src="https://mintcdn.com/dodopayments/kCngKZVrb0rZMS1f/images/customer-portal/subscription-details.png?fit=max&auto=format&n=kCngKZVrb0rZMS1f&q=85&s=4ae46f6878c9343b2e963c516952c9d3" alt="플랜 정보, 결제 수단, 청구 정보 및 취소 옵션을 보여주는 구독 세부 정보 페이지" width="2880" height="1560" data-path="images/customer-portal/subscription-details.png" />
</Frame>

## 구독 취소

고객은 구독 세부 정보 페이지에서 구독을 직접 취소할 수 있습니다. "Cancel Subscription"을 클릭하면 두 가지 옵션이 있는 확인 대화 상자가 열립니다:

* **Cancel at next billing date**: 구독은 현재 청구 기간이 끝날 때까지 유지되며, 이후 자동으로 취소됩니다.
* **Cancel now**: 구독이 즉시 취소됩니다.

<Frame>
  <img src="https://mintcdn.com/dodopayments/kCngKZVrb0rZMS1f/images/customer-portal/cance-sub.png?fit=max&auto=format&n=kCngKZVrb0rZMS1f&q=85&s=66eb6e380c991826c431fd0c563cbfa6" alt="다음 청구일에 취소하거나 즉시 취소 옵션이 있는 구독 취소 대화 상자" width="2880" height="1550" data-path="images/customer-portal/cance-sub.png" />
</Frame>

## 결제 수단 업데이트

고객은 구독 세부 정보 페이지의 결제 수단 옆에 있는 "Edit"을 클릭하여 직접 결제 수단을 업데이트할 수 있습니다. 실패한 결제로 인해 보류된 구독을 다시 활성화할 때 특히 중요합니다.

### 보류된 구독 재활성화

결제 실패로 인해 구독이 `on_hold` 상태로 전환되면 고객은 결제 수단을 업데이트하여 구독을 재활성화해야 합니다. 업데이트 프로세스는 자동으로 다음을 수행합니다:

1. **남은 금액에 대한 청구를 생성합니다**
2. **해당 청구에 대한 청구서를 생성합니다**
3. **새 결제 수단을 사용하여 결제를 처리합니다**
4. **성공적인 결제 후 구독을 `active` 상태로 재활성화합니다**

<Warning>
  `on_hold` 상태의 구독은 자동으로 갱신되지 않습니다. 고객은 결제 수단을 업데이트하여 미지급금을 정리하고 구독을 재활성화해야 합니다.
</Warning>

<Info>
  `on_hold` 구독의 결제 수단을 성공적으로 업데이트하면 고객은 확인 페이지를 보고 결제 및 구독 재활성화 성공에 대한 이메일 알림을 받습니다.
</Info>

### 결제 수단 업데이트 흐름

<Steps>
  <Step title="Access subscription details">
    포털 홈 페이지에서 활성 구독 중 아무 것이나 선택하고 "Manage subscription"을 클릭합니다.
  </Step>

  <Step title="Click Edit on payment method">
    결제 수단 옆의 "Edit" 버튼을 클릭하여 결제 수단 업데이트 인터페이스를 엽니다.
  </Step>

  <Step title="Select or add payment method">
    기존에 저장된 결제 수단을 선택하거나 카드 정보를 안전하게 입력하여 새 결제 수단을 추가합니다.
  </Step>

  <Step title="Confirm changes">
    업데이트를 확인합니다. `on_hold` 구독의 경우 이 작업은 남은 금액에 대한 청구를 자동으로 생성합니다.
  </Step>

  <Step title="Complete payment (if on hold)">
    구독이 보류된 상태인 경우 고객은 남은 금액 결제를 완료하도록 리디렉션됩니다. 결제가 성공하면 구독이 자동으로 재활성화됩니다.
  </Step>

  <Step title="Confirmation">
    고객은 결제 수단이 업데이트되었고 해당되는 경우 구독이 재활성화되었다는 확인을 받습니다.
  </Step>
</Steps>

## 통합 예시

특정 고객을 위해 시간 제한이 있는 고객 포털 세션을 API로 생성한 다음 사용자를 세션 URL로 리디렉션합니다.

<CodeGroup>
  ```typescript Node.js theme={null}
  const session = await client.customers.customerPortal.create('cus_123');

  // Redirect the user to the hosted Customer Portal
  window.location.href = session.link;
  ```
</CodeGroup>

## 통합 고객 포털

비즈니스 전용 고객 포털 외에도 Dodo Payments는 고객이 다양한 Dodo Payments 사업체의 모든 구매 및 구독을 확인하고 관리할 수 있는 **통합 고객 포털**을 [customer.dodopayments.com](https://customer.dodopayments.com)에서 제공합니다.

<Frame>
  <img src="https://mintcdn.com/dodopayments/eNGWg9ca-WxQ9nMf/images/changelog/unified-customer-portal.png?fit=max&auto=format&n=eNGWg9ca-WxQ9nMf&q=85&s=bceabb06ca0f00aa2a458f4af95a5cda" alt="통합 고객 포털" width="1640" height="953" data-path="images/changelog/unified-customer-portal.png" />
</Frame>

### 통합 포털 기능

* **기업 간 가시성**: 모든 Dodo Payments 판매자의 모든 구매 및 구독을 한 곳에서 확인합니다
* **중앙 집중식 관리**: 단일 대시보드에서 여러 사업체의 구독을 관리합니다
* **통합 청구 내역**: 모든 구매의 청구서 및 결제 내역을 확인합니다
* **싱글 사인온**: 이메일로 한 번 로그인하여 모든 Dodo Payments 판매자의 구매에 접근합니다

<Tip>
  통합 고객 포털은 비즈니스 전용 포털을 보완합니다. 고객은 선호도에 따라 브랜드가 적용된 판매자 포털 또는 통합 포털을 사용할 수 있습니다.
</Tip>

## 문제 해결

* **링크 만료됨**: 새 동적 링크를 생성하여 보내십시오.
* **이메일이 인식되지 않음**: 고객에게 구매에 사용한 이메일을 사용하도록 요청합니다
* **보류된 구독**: 구독이 보류 상태인 경우 고객은 포털을 통해 결제 수단을 업데이트하여 미지급금을 정리하고 구독을 재활성화해야 합니다. 업데이트 프로세스는 남은 금액에 대해 자동으로 청구합니다.
* **결제 수단 업데이트 실패**: `on_hold` 구독의 업데이트 프로세스 중 결제가 실패하면 구독은 보류 상태로 유지됩니다. 고객은 다른 결제 수단으로 다시 시도할 수 있습니다.

<Card title="Design & Theme Customization" icon="palette" href="/features/design">
  디자인 페이지에서 미리 만들어진 테마, 타이포그래피, 색상 및 라이브 미리보기를 사용하여 고객 포털 외관을 사용자화하세요.
</Card>

### 통합 포털 기능

* **비즈니스 간 가시성**: 모든 Dodo Payments 가맹점의 구매 및 구독을 한 곳에서 보기
* **중앙 집중식 관리**: 단일 대시보드에서 다양한 비즈니스의 구독 관리
* **통합 청구 이력**: 모든 구매의 인보이스 및 결제 이력 액세스
* **단일 사인온**: 이메일로 한 번 로그인하여 모든 Dodo Payments 가맹점의 구매에 액세스

<Tip>
  통합 고객 포털은 비즈니스별 포털을 보완합니다. 고객은 선호에 따라 브랜드 상표의 가맹점 포털 또는 통합 포털을 사용할 수 있습니다.
</Tip>

## 문제 해결

* **링크 만료됨**: 새 동적 링크를 생성하여 전송하십시오.
* **이메일 인식되지 않음**: 고객에게 구매와 관련된 이메일을 사용하도록 요청하십시오.
* **구독 보류 중**: 구독이 보류 중인 경우 고객은 포털을 통해 결제 수단을 업데이트하여 미납금을 정리하고 구독을 다시 활성화해야 합니다. 업데이트 과정에서 자동으로 미납금이 청구됩니다.
* **결제 수단 업데이트 실패**: `on_hold` 구독에 대한 업데이트 과정에서 결제가 실패하면 구독은 보류 상태로 유지됩니다. 고객은 다른 결제 수단으로 다시 시도할 수 있습니다.

<Card title="Design & Theme Customization" icon="palette" href="/features/design">
  사전 제작된 테마, 타이포그래피, 색상 및 디자인 페이지의 실시간 미리보기 기능으로 고객 포털의 외관을 사용자 정의합니다.
</Card>

Dodo Payments는 비즈니스별 고객 포털 외에도 고객이 Dodo Payments를 통해 다양한 비즈니스에서 모든 구매 및 구독을 조회하고 관리할 수 있는 **통합 고객 포털**을 [customer.dodopayments.com](https://customer.dodopayments.com)에서 제공합니다.

<Frame>
  <img src="https://mintcdn.com/dodopayments/eNGWg9ca-WxQ9nMf/images/changelog/unified-customer-portal.png?fit=max&auto=format&n=eNGWg9ca-WxQ9nMf&q=85&s=bceabb06ca0f00aa2a458f4af95a5cda" alt="Unified Customer Portal" style={{ maxHeight: '500px', width: 'auto' }} width="1640" height="953" data-path="images/changelog/unified-customer-portal.png" />
</Frame>

### 통합 포털 기능

* **비즈니스 간 가시성**: 모든 Dodo Payments 상인의 구매 및 구독을 한 곳에서 보기
* **중앙 집중식 관리**: 다양한 비즈니스의 구독을 단일 대시보드에서 관리
* **통합 청구 내역**: 모든 구매의 송장 및 결제 내역에 액세스
* **단일 로그인**: 이메일 한 번으로 모든 Dodo Payments 상인의 구매 액세스

<Tip>
  통합 고객 포털은 비즈니스별 포털을 보완합니다. 고객은 취향에 따라 브랜드화된 상인 포털 또는 통합 포털을 사용할 수 있습니다.
</Tip>

## 문제 해결

* **링크 만료**: 새로운 동적 링크를 생성하여 전송하십시오.
* **인증되지 않은 이메일**: 고객에게 구매와 연결된 이메일을 사용하라고 요청하십시오.
* **구독 보류 중**: 구독이 보류 중인 경우, 고객은 포털을 통해 결제 방법을 업데이트하여 미청구 금액을 해결하고 구독을 재활성화해야 합니다. 업데이트 프로세스는 남은 금액에 대해 자동으로 청구합니다.
* **결제 방법 업데이트 실패**: `on_hold` 구독의 업데이트 프로세스 중 결제가 실패하면 구독은 보류 상태로 유지됩니다. 고객은 다른 결제 방법으로 다시 시도할 수 있습니다.

<Card title="Design & Theme Customization" icon="palette" href="/features/design">
  디자인 페이지에서 사전 구축된 테마, 서체, 색상 및 실시간 미리보기를 사용하여 고객 포털의 외관을 사용자 정의하십시오.
</Card>