활성 정기 결제의 청구 금액을 변경하는 방법
활성 정기 결제의 청구 금액을 변경하려면 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/&lt;merchant ID>/<Publisher Account section>
.
api_key
는 생성 시 관리자 페이지에 한 번만 표시되며 사용자가 직접 저장해서 보관해야 합니다. 새 키를 생성할 수 있는 섹션 위치:- 회사 설정 > API 키
- 프로젝트 설정 > API 키
경로 매개변수로 전달:
매개 변수 | 유형 | 설명 |
---|---|---|
projectId | integer | 필수. 프로젝트 ID. 이 매개변수는 프로젝트 이름 옆의 관리자 페이지에서 찾을 수 있습니다. |
subscriptionId | integer | 필수. 정기 결제 ID. |
매개 변수 | 유형 | 설명 |
---|---|---|
amount | float | 필수. 청구 금액 값. |
currency | string | 필수. ISO 4217에 따른 3자리 통화 코드. |
Copy
- curl
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
- 정기 결제를 찾을 수 없음
이 기사가 도움이 되었나요?
의견을 보내 주셔서 감사드립니다!
메시지를 검토한 후 사용자 경험 향상에 사용하겠습니다.오자 또는 기타 텍스트 오류를 찾으셨나요? 텍스트를 선택하고 컨트롤+엔터를 누르세요.