고객 포털

​

고객 포털이란?

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

​

주요 이점

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

​

접근 방법

​

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

https://test.customer.dodopayments.com/login/{business_id}

https://customer.dodopayments.com/login/{business_id}

​

동적 링크 (매직 링크)

​

포털 기능

​

포털 개요

​

결제 수단 및 청구 내역

​

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

​

사용 가능한 작업

​

요금제 변경 작동 방식

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

​

비즈니스 제어

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

​

구독 세부 정보

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

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

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

​

결제 수단 업데이트

​

보류된 구독 재활성화

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

​

취소 사유

// Read the captured feedback after a customer cancels
const subscription = await client.subscriptions.retrieve('sub_123');
console.log(subscription.cancellation_feedback); // e.g., "too_expensive"
console.log(subscription.cancellation_comment);  // e.g., "Switching to a competitor"

​

결제 수단 업데이트

​

보류된 구독 재활성화

1. 청구 생성: 미납 금액에 대한 charge를 생성합니다
2. invoice 생성: charge에 대한 invoice를 생성합니다
3. 결제 처리: 새로운 결제 수단을 사용하여 결제를 처리합니다
4. 구독 재활성화: 결제가 성공하면 구독을 active 상태로 재활성화합니다

​

결제 수단 업데이트 플로우

​

통합 예시

const session = await client.customers.customerPortal.create('cus_123');

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

​

통합 Customer Portal

​

통합 포털 기능

• 비즈니스 간 가시성: 모든 Dodo Payments merchant의 구매 내역과 구독을 한곳에서 확인합니다
• 중앙 집중식 관리: 단일 dashboard에서 여러 비즈니스의 구독을 관리합니다
• 통합 billing history: 모든 구매 내역의 invoice와 결제 기록에 액세스합니다
• 통합 로그인: 이메일로 한 번 로그인하여 모든 Dodo Payments merchant의 구매 내역에 액세스합니다

​

문제 해결

• 링크 만료: 새 dynamic link를 생성하여 전송합니다.
• 이메일 인식 불가: 고객에게 구매에 사용한 이메일을 사용하도록 안내합니다
• 구독 보류: 구독이 보류된 경우 고객은 미납 금액을 정산하고 구독을 재활성화하기 위해 포털에서 결제 수단을 업데이트해야 합니다. 업데이트 프로세스에서 미납 금액이 자동으로 청구됩니다.
• 결제 수단 업데이트 실패: on_hold 구독의 업데이트 과정에서 결제가 실패하면 구독은 보류 상태로 유지됩니다. 고객은 다른 결제 수단으로 다시 시도할 수 있습니다.