메인 콘텐츠로 건너뛰기
고객 포털은 고객이 지원팀에 연락하지 않고도 구독을 관리하고, 청구서를 보고, 라이센스 키 세부정보에 접근할 수 있는 안전한 호스팅 영역입니다.

포털 세션 생성 (API)

프로그램적으로 안전하고 시간 제한이 있는 포털 세션을 생성합니다.

구독

정기 요금제, 업그레이드, 다운그레이드 및 추가 기능을 관리합니다.

고객 포털 개요 커버

​
고객 포털이란?

포털은 고객이 다음을 수행할 수 있는 신뢰할 수 있는 브랜드의 셀프 서비스 경험을 제공합니다:
  • 청구 내역 접근: 청구서를 보고 다운로드합니다.
  • 구독 관리: 구독을 취소합니다.
  • 결제 방법 업데이트: 활성 구독의 결제 방법을 변경하거나 보류 중인 구독을 재활성화합니다.
  • 라이센스 키 검색: 구매와 연결된 모든 키에 접근합니다.

​
주요 이점

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

​
접근 방법

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

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

고객은 만료되지 않는 정적 링크에 이메일을 입력하여 포털 접근을 요청할 수 있습니다. 정적 포털 링크 형식은 환경에 따라 다릅니다: 테스트 모드 (테스트 및 개발용): 
https://test.customer.dodopayments.com/login/{business_id}
실제 모드 (실제 거래용): 
https://customer.dodopayments.com/login/{business_id}
{business_id}를 실제 비즈니스 식별자로 교체한 후, 고객이 이메일을 입력하고 포털에 안전하게 접근할 수 있도록 적절한 링크를 공유합니다.
이메일 기반 로그인 화면
1

상인 흐름

  1. 판매 → 고객으로 이동합니다.
  2. 초대 공유를 클릭합니다.
  3. 정적 링크를 복사하여 고객과 공유합니다.
2

고객 흐름

  1. 정적 링크를 엽니다.
  2. 구매 시 사용한 이메일을 입력합니다.
  3. 포털에 접근하기 위한 안전한 로그인 링크를 받습니다.
기존 고객은 자동으로 인식됩니다.

​
동적 링크 (매직 링크)

고객을 포털로 직접 보내는 개인화된 일회성 매직 링크입니다. 링크는 24시간 후에 만료됩니다.
동적 링크는 24시간 후에 만료됩니다. 만료되면 새 링크를 생성하고 보내야 합니다.
매직 링크 직접 접근
1

상인 흐름

  1. 판매 → 고객으로 이동합니다.
  2. 초대 공유를 클릭합니다.
  3. 동적 링크를 복사하여 고객과 공유합니다.
2

고객 흐름

  1. 동적 링크를 엽니다.
  2. 이메일을 입력하지 않고 고객 포털에 직접 접근합니다.

​
포털 기능

청구 내역

모든 거래 및 청구서 세부정보를 봅니다. 계정에서 모든 청구서의 PDF를 다운로드합니다.

구독

활성 및 과거 구독을 검토하고 갱신 날짜를 포함합니다. 언제든지 요금제를 취소합니다.

결제 방법

구독의 결제 방법을 업데이트합니다. 미결제 금액을 정리하기 위해 결제 방법을 업데이트하여 보류 중인 구독을 재활성화합니다.

프로필

프로필 설정에서 이름, 이메일 및 전화번호를 직접 보고 업데이트합니다.

​
결제 방법 업데이트

고객은 고객 포털에서 직접 결제 방법을 업데이트할 수 있습니다. 이 기능은 결제 실패로 인해 보류 중인 구독을 재활성화하는 데 특히 중요합니다.

​
현재 결제 방법 보기

구독 관리 페이지에서 고객은 구독 세부정보와 함께 현재 결제 방법을 확인할 수 있습니다. 결제 방법 섹션에는 카드 유형, 마지막 4자리 및 업데이트를 위한 “편집” 버튼이 표시됩니다.
현재 결제 방법과 편집 옵션이 표시된 구독 세부정보 페이지

​
결제 방법 업데이트

고객이 결제 방법 섹션에서 “편집”을 클릭하면 다음을 수행할 수 있습니다:
  1. 기존 결제 방법 선택: 이전에 저장된 결제 방법 중에서 선택합니다.

    저장된 결제 방법을 보여주는 결제 방법 편집 모달

  2. 새 결제 방법 추가: 새 카드 세부정보를 안전하게 입력합니다.

    카드 입력 필드가 있는 결제 방법 업데이트 양식

​
보류 중인 구독 재활성화

구독이 on_hold 상태로 보류 중일 때, 고객은 재활성화를 위해 결제 방법을 업데이트해야 합니다. 업데이트 프로세스는 자동으로:
  1. 미결제 금액에 대한 청구 생성
  2. 청구에 대한 청구서 생성
  3. 새 결제 방법으로 결제 처리
  4. 성공적인 결제 후 구독을 active 상태로 재활성화
on_hold 상태의 구독은 자동으로 갱신되지 않습니다. 고객은 미결제 금액을 정리하고 구독을 재활성화하기 위해 결제 방법을 업데이트해야 합니다.
on_hold 구독의 결제 방법을 성공적으로 업데이트한 후, 고객은 확인 페이지를 보고 성공적인 결제 및 구독 재활성화에 대한 이메일 알림을 받게 됩니다.
결제 방법 업데이트 및 구독 재활성화를 확인하는 결제 성공 페이지

​
결제 방법 업데이트 흐름

1

구독 세부정보 접근

고객 포털의 구독 관리 페이지로 이동하여 구독 세부정보와 현재 결제 방법을 봅니다.
2

결제 방법에서 편집 클릭

결제 방법 섹션 옆의 “편집” 버튼을 클릭하여 결제 방법 업데이트 인터페이스를 엽니다.
3

결제 방법 선택 또는 추가

기존에 저장된 결제 방법을 선택하거나 카드 세부정보를 안전하게 입력하여 새 결제 방법을 추가합니다.
4

변경 사항 확인

“변경 사항 확인”을 클릭하여 결제 방법을 업데이트합니다. on_hold 구독의 경우, 이는 자동으로 미결제 금액에 대한 청구를 생성합니다.
5

결제 완료 (보류 중인 경우)

구독이 보류 중인 경우, 고객은 미결제 금액을 완료하기 위해 리디렉션됩니다. 성공적인 결제 후 구독이 자동으로 재활성화됩니다.
6

확인

고객은 결제 방법이 업데이트되었고, 해당되는 경우 구독이 재활성화되었다는 확인을 받습니다.

​
통합 예제

특정 고객을 위한 시간 제한이 있는 고객 포털 세션을 API를 통해 생성한 후, 사용자를 세션 URL로 리디렉션합니다. 
const session = await client.customers.customerPortal.create('cus_123');

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

​
문제 해결

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