활성 정기 결제의 청구 금액을 변경하는 방법
활성 정기 결제의 청구 금액을 변경하려면 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/<merchant_id>.
api_key는 생성 시 관리자 페이지에 한 번만 표시되며 사용자가 직접 저장해서 보관해야 합니다. 다음 섹션에서 새로운 키를 생성할 수 있습니다:- 회사 설정 > API 키
- 프로젝트 설정 > API 키
이러한 매개 변수를 찾으려면 계정으로 이동하십시오:
merchant_id표시 위치:- 회사 설정 > 회사 섹션.
- 계정의 브라우저 주소 표시줄에 있는 URL에서. URL 형식은 다음과 같습니다:
https://xsolla.com/for/free-to-play-pc/account/<merchant_id>.
api_key는 생성 시 계정에 한 번만 표시되며 사용자가 직접 저장해서 보관해야 합니다. 다음 섹션에서 새로운 키를 생성할 수 있습니다:- 회사 설정 > API 키
- 설정 > API 키
이러한 매개 변수를 찾으려면 계정으로 이동하십시오:
merchant_id표시 위치:- 회사 설정 > 회사 섹션.
- 계정의 브라우저 주소 표시줄에 있는 URL에서. URL 형식은 다음과 같습니다:
https://xsolla.com/for/premium-pc-games/account/<merchant_id>.
api_key는 생성 시 계정에 한 번만 표시되며 사용자가 직접 저장해서 보관해야 합니다. 다음 섹션에서 새로운 키를 생성할 수 있습니다:- 회사 설정 > API 키
- 설정 > API 키
이러한 매개 변수를 찾으려면 계정으로 이동하십시오:
merchant_id표시 위치:- 회사 설정 > 회사 섹션.
- 계정의 브라우저 주소 표시줄에 있는 URL에서. URL 형식은 다음과 같습니다:
https://xsolla.com/for/web-games/account/<merchant_id>.
api_key는 생성 시 계정에 한 번만 표시되며 사용자가 직접 저장해서 보관해야 합니다. 다음 섹션에서 새로운 키를 생성할 수 있습니다:- 회사 설정 > API 키
- 설정 > API 키
| 매개 변수 | 유형 | 설명 |
|---|---|---|
projectId | integer | 필수. 프로젝트 ID. |
이 매개변수는 프로젝트 이름 옆의 관리자 페이지에서 찾을 수 있습니다.
이 매개 변수는 계정의 프로젝트 이름 옆에서 찾을 수 있습니다.
이 매개 변수는 계정의 프로젝트 이름 옆에서 찾을 수 있습니다.
이 매개 변수는 계정의 프로젝트 이름 옆에서 찾을 수 있습니다.
| 매개 변수 | 유형 | 설명 |
|---|---|---|
subscriptionId | integer | 필수. 정기 결제 ID. |
| 매개 변수 | 유형 | 설명 |
|---|---|---|
amount | float | 필수. 청구 금액 값. |
currency | string | 필수. ISO 4217에 따른 3자리 통화 코드. |
- curl
1curl -X PATCH \
2'https://subscriptions.xsolla.com/api/v1/projects/{project_id}/subscriptions/{subscription_id}/price' \
3 -H 'accept: application/json' \
4 -H 'Authorization: Basic'
5
6{
7 "amount": 4.99,
8 "currency": "USD"
9}
응답 예제:
200- 청구 금액이 성공적으로 변경됨400- 정기 결제가 활성화되지 않음404- 정기 결제를 찾을 수 없음
오자 또는 기타 텍스트 오류를 찾으셨나요? 텍스트를 선택하고 컨트롤+엔터를 누르세요.