Xsolla-logo
  • 문서화
  • 계정 생성

정기결제 업데이트

put/projects/{project_id}/users/{user_id}/subscriptions/{subscription_id}

상태를 변경하여 구독 업데이트 (active, canceled, 혹은 non_renewing) 혹은 다음 청구일 연기.

SecuritybasicAuth
Request
path Parameters
project_id
required
integer

프로젝트 ID.

user_id
required
string

사용자 ID.

subscription_id
required
integer

정기결제 ID입니다.

Request Body schema: application/json
cancel_subscription_payment
boolean

true로 설정한 경우, 본 구독 최종 결제 금액이 환불됩니다. 이 옵션은 상태가 canceled로 설정된 경우에만 작동합니다.

status
string

상태.

Enum: "active" "canceled" "non_renewing"
object

청구 연기.

type
string

청구 기간 단위. day 또는 month.

Enum: "day" "month"
value
string

청구를 연기할 시간 단위 수. 값은 유형 매개변수에 따라 다음과 같습니다:
- 1 ~ 366, typeday인 경우
- 1 ~ 12, typemonth인 경우

user_id
string

사용자 ID.

object
collaborator_id
string

협력자 ID — 인플루언서 혹은 제휴 네트워크 식별자. 이는 관리자 페이지 > 파트너 네트워크 > 인플루언서 섹션에서 찾을 수 있습니다.

Responses
200

OK (확인).

Request samples
application/json
{
  • "status": "active"
}
Response samples
application/json
{
  • "charge_amount": 0.03,
  • "currency": "USD",
  • "date_create": "2018-09-21T16:54:59+0300",
  • "date_end": null,
  • "date_last_charge": "2018-09-21T16:55:05+0300",
  • "date_next_charge": "2018-09-21T16:55:05+0300",
  • "id": 24953579,
  • "plan": {
    },
  • "product": null,
  • "status": "active",
  • "user": {
    }
}