사용자가 정기 결제 플랜을 변경하도록 허용하는 방법

작동 방식

• 새 플랜을 선택하면 현재 정기 결제 기간 중 사용하지 않은 기간에 해당하는 금액이 사용자의 잔액으로 환불됩니다.
• 새 정기 결제 플랜에 대한 결제는 모두 사용자의 잔액으로 진행됩니다. 잔액이 부족한 경우 프로젝트에서 허용된 결제 방식 중 하나를 사용하여 추가 결제가 이루어집니다.
• 플랜을 변경할 때 다음 청구 기간부터 플랜을 변경하도록 프로젝트가 구성되어 있더라도 결제가 확인되는 즉시 상품 금액이 인출됩니다.

• 새 플랜의 통화가 현재 플랜 통화와 다른 경우, 새 플랜 구매는 통화 변환을 통해 이루어집니다.

• 사용자에게 현재 플랜에서 변경되는 플랜에 대한 활성 정기 결제가 이미 있는 경우.
• 사용자가 변경하려는 정기 결제가 활성 상태가 아닌 경우.
• 사용자가 변경하려는 정기 결제 플랜이 라이프타임 플랜 유형인 경우: 해당 정기 결제는 지정된 환불 기간에만 취소할 수 있습니다.

획득 방법

1. 프로젝트를 관리자 페이지에서 엽니다.
2. 사이드바에서 정기 결제클릭한 후 설정 섹션으로 이동합니다.
3. 플랜 변경하기 섹션에서 다른 플랜 선택 기능 토글을 On(켜짐)으로 설정합니다.
4. 기본적으로 다음 기간부터 플랜 변경이 허용됩니다. 현재 기간 동안 플랜을 변경할 수 있도록 허용하려면 지금을 선택합니다. 이 옵션을 선택하면 결제가 확인되는 즉시 플랜이 변경됩니다.
5. 하루에 한 번 이상 플랜을 변경할 수 있도록 하려면 동일한 날짜에 여러 번 다른 플랜을 선택할 수 있는 기능을 On(켜짐)으로 설정합니다.
6. 결제 인터페이스를 열 때 다음을 사용합니다.
   • 서버 측 토큰 생성 API 호출
   • 프로젝트에서 엑솔라 로그인을 사용하는 경우 결제 UI를 여는 링크를 가져오기 위한 클라이언트 측 API 호출

서버 측 토큰 생성 API 호출을 통해 결제 UI 열기

1. 메소드에 다음을 전달하여 결제 UI를 열기 위한 토큰 받기:
   • purchase.subscription.operation 매개변수에 있는 change_plan 값.
   • purchase.subscription.plan_id 매개변수에 있는 새 플랜의 ID.
   • 정기 결제 기반 상품을 이용하는 경우 purchase.subscription.product_id 매개변수의 정기 결제 기반 상품 ID. 이를 구하려면 고객 성공 매니저에게 문의하거나 csm@xsolla.com으로 이메일을 보내주세요.
2. 결제 인터페이스 열기를 구현하는 방법:
   • 페이 스테이션 임베드 스크립트
   • iframe
   • 새 창

클라이언트 측 API 호출을 사용하여 정기 결제 관리 페이지에서 결제 UI 열기

프로젝트에 엑솔라 로그인이 구성되어 있는 경우 클라이언트 측 API 호출을 사용하여 결제 인터페이스를 여는 링크를 가져올 수 있습니다. 응답으로 반환된 링크를 통해 정기 결제 관리 페이지에서 결제 UI를 열 수 있으며, 사용자는 활성 정기 결제를 선택하고 변경할 수 있습니다.

이렇게 하려면 애플리케이션의 클라이언트 측에서 HTTP POST 요청을 사용하여 결제 인터페이스에 대한 링크 수신(https://subscriptions.xsolla.com​/api/user/v1/projects/{project_id}/subscriptions/manage)을 구현합니다. 요청에 Authorization: Bearer <client_user_jwt> 헤더를 포함해야 합니다. 여기서 <client_user_jwt>는 사용자의 JSON 웹 토큰(JWT)으로 Base64 표준에 따라 인코딩한 고유한 토큰입니다. 토큰을 받는 방법:

• 애플리케이션에서 로그인과 암호 인증을 사용하는 경우 Register new user와 Auth by username을 사용합니다.
• 애플리케이션에서 소셜 네트워크를 통한 인증을 사용하는 경우 Auth via social network API 호출을 사용합니다.

필요한 경우 사용자 정의용 추가 매개변수를 전달하세요.

요청 본문 매개변수:

curl -X 'POST' \
'https://subscriptions.xsolla.com/api/user/v1/projects/{project_id}/subscriptions/manage?country=RU  ' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer client_user_jwt'
{
  "settings": {
    "ui": {
      "size": "large",
      "theme": "string",
      "version": "desktop",
      "desktop": {
        "header": {
          "is_visible": true,
          "visible_logo": true,
          "visible_name": true,
          "type": "compact",
          "close_button": true
        }
      },
      "mobile": {
        "mode": "saved_accounts",
        "footer": {
          "is_visible": true
        },
        "header": {
          "close_button": true
        }
      },
      "license_url": "string",
      "mode": "user_account",
      "user_account": {
        "history": {
          "enable": true,
          "order": 1
        },
        "payment_accounts": {
          "enable": true,
          "order": 1
        },
        "info": {
          "enable": true,
          "order": 1
        },
        "subscriptions": {
          "enable": true,
          "order": 1
        }
      }
    },
    "currency": "str",
    "locale": "st",
    "external_id": "string",
    "payment_method": 1,
    "return_url": "string",
    "redirect_policy": {
      "redirect_conditions": "none",
      "delay": 0,
      "status_for_manual_redirection": "none",
      "redirect_button_caption": "string"
    }
  }
}

응답 예제:

{
  "link_to_ps": "https://secure.xsolla.com/paystation2/?access_token=<access_token>"
}