고객 포털

​

고객 포털이란?

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

​

주요 이점

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

​

접근 방법

​

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

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

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

​

동적 링크 (매직 링크)

​

포털 기능

​

포털 개요

​

결제 수단 및 청구 내역

​

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

​

사용 가능한 작업

​

요금제 변경 작동 방식

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

​

비즈니스 제어

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

1. 고객이 구독 세부 정보 페이지에서 Change Plan을 클릭합니다.
2. 제품 컬렉션을 기준으로 이용 가능한 업그레이드/다운그레이드 옵션이 표시됩니다.
3. 고객이 새 플랜을 선택합니다. Confirm Plan Change 패널에 현재 플랜과 변경된 플랜, 항목별 내역(기존 플랜에 대한 크레딧, 새 플랜에 대한 청구 금액), 세금 및 현재 결제해야 할 금액이 표시됩니다. 고객은 여기에서 할인 코드도 추가할 수 있습니다.
4. 고객이 **Pay ${amount}**를 클릭하여 확인합니다.
5. 일할 계산이 적용되고 결제가 처리됩니다. 저장된 결제 수단으로 처리되거나, 비즈니스에서 payment link를 통해 플랜 변경 결제를 수집하는 경우 호스팅된 checkout 페이지를 통해 처리됩니다(아래 참조).
6. 구독이 새 플랜으로 업데이트됩니다. 업데이트가 즉시 적용되는지, 아니면 결제가 완료된 후에만 적용되는지는 payment failure handling에 따라 달라집니다. payment link로 결제한 플랜 변경은 항상 결제가 완료될 때까지 대기합니다.

​

Payment Link를 통한 플랜 변경 결제 수집

​

비즈니스 제어

• Allow Subscription Updates: 고객이 구독을 업그레이드하거나 다운그레이드할 수 있는 기능을 활성화하거나 비활성화합니다.
• Allow Subscription Cancellation: 고객이 직접 구독을 취소할 수 있는 기능을 활성화하거나 비활성화합니다.
• Allow Subscription Pause: 고객이 직접 구독을 일시 중지하고 재개할 수 있는 기능을 활성화하거나 비활성화합니다.
• Collect Plan Change Payments by Payment Link: 저장된 결제 수단으로 청구하는 대신 즉시 플랜 변경 비용을 결제할 checkout 페이지로 고객을 이동합니다. 기본값은 비활성화입니다.

​

구독 세부 정보

• 플랜 세부 정보: 구독 이름, 가격, 갱신일 및 유효 기간
• 결제 수단: 구독에 연결된 카드 또는 결제 수단과 “Edit” 버튼
• 청구 정보: 이름, 이메일, 전화번호 및 청구 주소와 “Edit” 버튼
• 청구 내역: 해당 구독의 모든 결제 내역을 보여주는 상세 표
• Pause: 셀프서비스 일시 중지를 허용한 경우 표시되는 구독 일시 중지 옵션
• Cancel Subscription: 구독을 취소하는 눈에 띄는 버튼

​

구독 취소

• 다음 billing date에 취소: 현재 billing period가 종료될 때까지 구독이 활성 상태로 유지된 후 자동으로 취소됩니다.
• 지금 취소: 구독이 즉시 취소됩니다.

​

취소 사유

// 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"

​

구독 일시 중지

• 액세스가 즉시 중단됩니다. 구독에 포함된 기능, 다운로드 및 라이선스 키는 구독이 재개될 때까지 작동하지 않습니다.
• 일시 중지 종료일은 없습니다. 고객이 재개할 때까지 구독은 일시 중지 상태로 유지됩니다.
• 시간이 손실되지 않습니다. 다음 billing date와 renewal date가 모두 일시 중지 기간만큼 뒤로 이동합니다.

​

결제 수단 업데이트

​

보류 상태의 구독 재활성화

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

​

문제 해결

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