활성 정기 결제의 청구 금액을 변경하는 방법

활성 정기 결제의 청구 금액을 변경하려면 HTTP-PATCH 요청 https://subscriptions.xsolla.com​/api/v1/projects/{projectId}/subscriptions/{subscriptionId}/price을 실행합니다.

알림

청구 금액을 변경하면 사용자에게 이메일로 알림이 전송되며, 새 금액은 다음 청구 기간부터 적용됩니다.

새 정기 결제의 청구 금액을 변경하려면 플랜 업데이트 메소드를 사용해야 합니다. 새 금액은 새 정기 결제에만 적용되며 모든 기존 정기 결제는 이전 약관에 따라 계속 유지됩니다.

요청에는 Authorization: Basic <your_authorization_basic_key> 헤더가 있어야 합니다. 여기서 <your_authorization_basic_key>는 Base64 표준에 따라 인코딩된 merchant_id:api_key 쌍입니다.

이러한 매개변수를 찾으려면 관리자 페이지으로 이동합니다.

  • merchant_id 표시 위치:
    • 프로젝트 설정 > 웹훅 섹션.
    • 회사 설정 > 회사 섹션.
    • 관리자 페이지 페이지의 브라우저 주소 표시줄에 있는 URL. URL의 형식: https://publisher.xsolla.com/&amp;lt;merchant ID>/<Publisher Account section>.
  • api_key는 생성 시 관리자 페이지에 한 번만 표시되며 사용자가 직접 저장해서 보관해야 합니다. 새 키를 생성할 수 있는 섹션 위치:
    • 회사 설정 > API 키
    • 프로젝트 설정 > API 키

경로 매개변수로 전달:

매개 변수유형설명
projectId
integer필수. 프로젝트 ID. 이 매개변수는 프로젝트 이름 옆의 관리자 페이지에서 찾을 수 있습니다.
subscriptionId
integer필수. 정기 결제 ID.
요청 본문으로 전달:
매개 변수유형설명
amount
float필수. 청구 금액 값.
currency
string필수. ISO 4217에 따른 3자리 통화 코드.
요청 예제:
Copy
Full screen
Small screen
curl -X PATCH \
'https://subscriptions.xsolla.com/api/v1/projects/{project_id}/subscriptions/{subscription_id}/price' \
  -H 'accept: application/json' \
  -H 'Authorization: Basic'

{
  "amount": 4.99,
  "currency": "USD"
}

응답 예제:

  • 200 - 청구 금액이 성공적으로 변경됨
  • 400 - 정기 결제가 활성화되지 않음
  • 404 - 정기 결제를 찾을 수 없음
이 기사가 도움이 되었나요?
감사합니다!
개선해야 할 점이 있을까요? 메시지
유감입니다
이 기사가 도움이 안 된 이유를 설명해 주세요. 메시지
의견을 보내 주셔서 감사드립니다!
메시지를 검토한 후 사용자 경험 향상에 사용하겠습니다.
마지막 업데이트: 2024년 7월 31일

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

문제 보고
콘텐츠를 항상 검토합니다. 여러분의 피드백은 콘텐츠를 개선에 도움이 됩니다.
후속 조치를 위해 이메일을 제공해 주세요
의견을 보내 주셔서 감사드립니다!