사용자 정기 결제 관리

애플리케이션에서 정기 결제 관리를 구현하려면 다음 논리를 따르십시오:

  1. 사용자의 정기 결제 목록을 검색하여 애플리케이션에 표시합니다.
  2. 정기 결제 관리 구현 - 애플리케이션에서 직접 구독자 계정을 개설하거나 특정 정기 결제를 관리할 수 있습니다.

구현을 간소화하려면 예제를 참조하십시오.

참고

정기 결제 구매 및 관리 기능은 인증된 사용자만 이용할 수 있습니다. 사용자 인증을 위한 SDK 사용 방법에 대한 자세한 내용은 인증 섹션을 참조하십시오.

코드 예제에서는 정기 결제 워크플로 시연을 간소화하기 위해 하드코딩된 자격 증명과 함께 사용자 이름과 비밀번호를 통한 인증(XsollaAuth.SignIn 메서드)을 사용합니다. 실제 애플리케이션에서는 XsollaAuth.AuthBySavedToken 메서드를 사용하여 완전한 인증 논리와 현재 세션 유효성 검사를 구현해야 합니다.

사용자 정기 결제 검색

현재 사용자의 모든 활성 정기 결제를 조회하려면 XsollaSubscriptions.GetSubscriptions 메서드를 사용하세요. 이 메서드는 현재 사용자의 계정에 연결된 active, non_renewing, freeze 상태의 정기 결제를 반환합니다.

또한 XsollaSubscriptions.GetSubscriptionDetails 메서드를 사용하여 각 정기 결제에 대한 세부 정보를 조회할 수 있습니다.

반환된 데이터(SubscriptionItem 개체)를 사용하여 애플리케이션에 정기 결제 관리 UI를 표시합니다.

UI 위젯을 구성하는 주요 필드:

  • plan_name - 정기 결제 이름.
  • status - 현재 정기 결제 상태(new, active, canceled, non_renewing, freeze).
  • date_next_charge - 다음 자동 청구 날짜 및 시간.
  • charge - 정기 결제 정보. 개체는 가격(amount) 및 통화(currency)를 포함합니다.

정기 결제 관리

알림
정기 결제 변경 및 해지를 처리하려면 웹훅 처리를 구현해야 합니다. 웹훅 구성 및 테스트에 대한 자세한 내용은 정기 결제 정보 가져오기 섹션을 참조하십시오.

구독자 계정 개설

엑솔라는 사용자가 정기 결제 정보를 확인하고 관리할 수 있는 기성 UI인 ‘구독자 계정’을 제공합니다. 이는 구독 관리 기능을 구현하는 가장 간단하고 권장되는 방법입니다.

주요 기능:

  • 정기 결제 정보 보기
  • 정기 결제 관리 - 즉시 취소, 자동 갱신 중지 또는 재활성화(프로젝트 설정에 따라 다름)
  • 정기 결제 요금제 변경
  • 결제 방식 업데이트

사용자에게 구독자 계정을 표시하려면 XsollaSubscriptions.GetUserAccountUrl 메서드를 호출하십시오. 요청이 성공하면 계정 UI로 연결되는 링크를 포함하는 UserAccountLink 개체가 콜백 함수로 전달됩니다. 이 링크를 외부 브라우저나 내장형 WebView에서 열려면 XsollaWebBrowser.Open 메서드를 사용하십시오.

정기 결제 관리

애플리케이션에서 특정 정기 결제에 대한 관리 UI를 열려면 XsollaSubscriptions.GetSubscriptionManagementUrl 메서드를 호출하십시오. 요청이 성공하면 정기 결제 관리 UI로 연결되는 링크를 포함하는 PaymentLink 개체가 콜백 함수로 전달됩니다. 이 링크를 외부 브라우저나 내장형 WebView에서 열려면 XsollaWebBrowser.Open 메서드를 사용하십시오.

정기 결제 취소

애플리케이션 UI에서 정기 결제 취소를 구현하려면 XsollaSubscriptions.CancelSubscription 메서드를 사용하십시오. 이 메서드는 자동 갱신을 비활성화하며, 정기 결제 상태는 non_renewing으로 전환됩니다. 즉, 다음 청구 기간에는 자동 청구가 이루어지지 않으며, 정기 결제는 결제 기간이 끝날 때까지 활성 상태로 유지됩니다.

정기 결제 갱신

애플리케이션에서 정기 결제 갱신 UI로 이동하는 기능을 구현하려면 XsollaSubscriptions.GetSubscriptionRenewalUrl 메서드를 사용하십시오. 요청이 성공하면 정기 결제 갱신 UI로 연결되는 링크를 포함하는 PaymentLink 개체가 콜백 함수로 전달됩니다. 외부 브라우저나 내장 WebView에서 링크를 열려면 XsollaWebBrowser.Open 메서드를 사용하십시오.

이 기사가 도움이 되었나요?
감사합니다!
개선해야 할 점이 있을까요? 메시지
유감입니다
이 기사가 도움이 안 된 이유를 설명해 주세요. 메시지
의견을 보내 주셔서 감사드립니다!
메시지를 검토한 후 사용자 경험 향상에 사용하겠습니다.
마지막 업데이트: 2026년 4월 14일

오자 또는 기타 텍스트 오류를 찾으셨나요? 텍스트를 선택하고 컨트롤+엔터를 누르세요.

문제 보고
콘텐츠를 항상 검토합니다. 여러분의 피드백은 콘텐츠를 개선에 도움이 됩니다.
후속 조치를 위해 이메일을 제공해 주세요
의견을 보내 주셔서 감사드립니다!
피드백을 보내는 중 문제가 발생했습니다
잠시 후 다시 시도하거나 doc_feedback@xsolla.com으로 연락해 주세요.