고객 포털

​

Customer Portal이란 무엇인가요?

• 결제 내역 액세스: 이전 결제를 확인하고 인보이스를 다운로드합니다.
• 구독 관리: 구독 세부 정보를 확인하고, 설정에 따라 구독을 일시 중지 및 재개하거나 즉시 또는 다음 결제일에 취소합니다.
• 결제 수단 업데이트: 구독의 결제 수단을 변경하거나 보류된 구독을 다시 활성화합니다.
• 라이선스 키 가져오기: 구매에 연결된 라이선스 키를 확인합니다.
• 앱으로 돌아가기: return_url를 전달하면 포털에 비즈니스로 돌아가는 링크가 표시됩니다. 모바일에서는 헤더의 뒤로 가기 화살표를 누르면 포털 개요로 돌아갑니다.

​

주요 이점

• 지원 요청 감소: 고객이 일반적인 결제 요청을 직접 처리합니다.
• 빠른 액세스: 고객은 로그인하는 즉시 인보이스와 라이선스 키를 확인할 수 있습니다.
• 이탈 위험 감소: 고객은 요금이 청구되기 전에 갱신일과 플랜 세부 정보를 확인할 수 있습니다.
• 서명 및 만료되는 링크: 모든 로그인 링크는 서명되며 24시간 후 만료됩니다.
• 현지화된 경험: 포털은 21개 언어로 제공되며 고객 브라우저 설정에서 언어를 선택합니다.

​

액세스 방법

​

정적 링크(이메일 기반 액세스)

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

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

​

동적 링크(Magic Link)

​

포털 기능

​

포털 개요

​

결제 수단 및 청구 내역

​

언어 지원

​

언어 선택 방식

• 자동 감지: 최초 방문 시 포털이 브라우저의 기본 설정 언어를 읽고 지원되는 언어이면 해당 언어로 로드합니다. 지원되지 않으면 영어를 사용합니다.
• 수동 변경: 고객은 데스크톱과 모바일에서 페이지 오른쪽 아래의 언어 선택기를 사용하여 언제든지 언어를 변경할 수 있습니다.
• 환경 설정 저장: 포털은 NEXT_LOCALE cookie에 선택한 언어를 1년 동안 저장하므로 방문할 때마다 해당 언어를 기억합니다.

​

지원 언어

​

플랜 변경(업그레이드/다운그레이드)

​

사용 가능한 작업

​

플랜 변경 방식

1. 고객이 구독 세부 정보 페이지에서 Change Plan을 클릭합니다.
2. 포털에 Product Collection의 다른 플랜이 표시됩니다.
3. 고객이 플랜을 선택합니다. Confirm Plan Change 패널에는 현재 플랜과 변경된 플랜, 항목별 내역(기존 플랜에 대한 크레딧 및 새 플랜에 대한 청구 금액), 세금 및 지금 결제할 금액이 표시됩니다. 이곳에서 할인 코드도 입력할 수 있습니다.
4. 고객이 결제할 금액이 표시된 Pay 버튼으로 확인합니다.
5. Dodo Payments가 일할 계산을 수행하고 저장된 결제 수단에서 금액을 청구합니다. 플랜 변경 결제를 payment link로 수금하도록 설정한 경우에는 호스팅된 checkout 페이지에서 결제합니다(Collecting Plan Change Payments by Payment Link 참조).
6. 구독이 새 플랜으로 이동합니다. 이 작업이 즉시 수행되는지, 아니면 청구가 성공한 후에만 수행되는지는 payment failure handling에 따라 달라집니다. payment link로 결제한 플랜 변경은 항상 결제를 기다립니다.

​

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

​

Business 제어

• Allow Subscription Updates: 고객이 업그레이드 또는 다운그레이드할 수 있습니다. 기본값은 꺼짐입니다.
• Allow Immediate Cancellation: 고객이 구독을 즉시 종료하고 액세스 권한을 잃도록 합니다. 기본값은 켜짐입니다.
• Allow Cancellation at Next Billing Date: 고객이 결제한 기간이 끝날 때 구독을 취소할 수 있습니다. 기본값은 켜짐입니다.
• Allow Subscription Pause: 고객이 직접 구독을 일시 중지하고 재개할 수 있습니다. 기본값은 꺼짐입니다.
• Collect Plan Change Payments by Payment Link: 저장된 결제 수단으로 청구하는 대신 고객을 checkout 페이지로 보내 즉시 플랜 변경 비용을 결제하도록 합니다. 기본값은 꺼짐입니다.

​

구독 세부 정보

• 플랜 세부 정보: 구독 이름, 가격, 갱신일 및 유효 기간입니다.
• 결제 수단: 구독에 사용되는 결제 수단과 Edit 버튼입니다.
• 결제 정보: 이름, 이메일, 전화번호 및 청구 주소와 이름 및 청구 주소를 수정하는 Edit 버튼입니다.
• 결제 내역: 이 구독의 모든 결제가 표시된 표입니다.
• Pause Subscription: 셀프 서비스 일시 중지를 허용한 경우 표시됩니다.
• Cancel Subscription: 취소 대화 상자를 엽니다.

​

구독 취소

• Cancel at next billing date: 현재 결제 기간이 끝날 때까지 구독이 활성 상태로 유지된 후 취소됩니다.
• Cancel now: 구독이 즉시 취소됩니다.

​

취소 사유

// `client` is a DodoPayments client, created as in the Integration Guide.
// 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로 다시 활성화합니다

​

Grace Period의 구독 재활성화

​

결제 수단 업데이트 흐름

​

Integration 예시

// Server: `client` is a DodoPayments client, created as in the Integration Guide.
const session = await client.customers.customerPortal.create('cus_123', {
  return_url: 'https://yourapp.com/account', // optional: shown as a back link in the portal
});

// Send session.link to the browser, then redirect the customer:
// window.location.href = session.link;

​

Unified Customer Portal

​

Unified Portal 기능

• 비즈니스 간 통합 보기: 모든 Dodo Payments merchant의 구매 내역과 구독을 한곳에서 확인합니다.
• 중앙 집중식 관리: 하나의 사이트에서 여러 비즈니스의 구독을 관리합니다.
• 통합 결제 내역: 모든 구매의 인보이스와 결제 내역에 액세스합니다.
• 단일 로그인: 이메일 주소로 한 번 로그인하여 모든 Dodo Payments merchant의 구매 내역에 액세스합니다.

​

문제 해결

• 링크 만료: 새 동적 링크를 생성하여 고객에게 보냅니다.
• 이메일 인식 안 됨: 고객에게 구매에 사용한 이메일 주소를 사용하도록 안내합니다. 비즈니스 고객이 아닌 주소로는 로그인 이메일이 전송되지 않습니다.
• 보류된 구독: 고객이 포털에서 결제 수단을 업데이트합니다. Dodo Payments는 결제가 성공하면 남은 미납 금액을 청구하고 구독을 다시 활성화합니다.
• 결제 수단 업데이트 실패: on_hold 상태의 구독에서 결제 수단을 업데이트하는 중 결제에 실패하면 구독은 보류 상태로 유지됩니다. 고객은 다른 결제 수단으로 다시 시도할 수 있습니다.