고객 포털

​

고객 포털이란?

• 청구 내역 확인: 인보이스를 확인하고 영수증을 다운로드합니다.
• 구독 관리: 구독 세부 정보를 확인하고, 구독을 일시 중지 및 재개하거나 즉시 또는 다음 청구일에 구독을 취소합니다.
• 결제 수단 업데이트: 활성 구독의 결제 수단을 변경하거나 보류된 구독을 재활성화합니다.
• 라이선스 키 확인: 구매 항목에 연결된 모든 키에 액세스합니다.
• 간편한 탐색: 뒤로 가기 버튼을 사용해 현재 위치를 유지한 채 포털 섹션 간에 이동합니다.

​

주요 이점

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

​

접근 방법

​

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

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: 구독을 취소하는 눈에 띄는 버튼

• 구독 업데이트 허용: 고객이 구독을 업그레이드하거나 다운그레이드할 수 있는 기능을 활성화하거나 비활성화합니다.
• 구독 취소 허용: 고객이 직접 구독을 취소할 수 있는 기능을 활성화하거나 비활성화합니다.
• 구독 일시 중지 허용: 고객이 직접 구독을 일시 중지하고 재개할 수 있는 기능을 활성화하거나 비활성화합니다.

• 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. 미납 잔액에 대한 청구를 생성합니다.
2. 해당 청구에 대한 인보이스를 생성합니다.
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의 구매 내역과 구독을 한곳에서 확인합니다.
• 중앙 집중식 관리: 단일 대시보드에서 여러 비즈니스의 구독을 관리합니다.
• 통합 청구 내역: 모든 구매 항목의 인보이스와 결제 내역에 액세스합니다.
• 통합 로그인: 이메일로 한 번 로그인하여 모든 Dodo Payments merchant의 구매 내역에 액세스합니다.

​

문제 해결

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