정기 결제 업데이트

Xsolla Developers

또는

관리자 페이지로

정기 결제 업데이트Server-sideAdmin

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 청구를 연기할 시간 단위 수입니다. 값은 유형 매개 변수에 따라 달라지며 다음이 될 수 있습니다: - `type`이 `day`인 경우 1366, `type`이 `month`인 경우 112

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": {"billing_retry": {"value": 1
},
"charge": {"amount": 0.03,
"currency": "USD",
"period": {"type": "day",
"value": 1
}
},
"description": null,
"expiration": {"type": "day",
"value": 0
},
"external_id": "lowcost",
"grace_period": {"type": "day",
"value": 2
},
"group_id": "newPlans",
"id": 66001,
"localized_name": null,
"name": null,
"project_id": 18404,
"refund_period": null,
"status": {"value": "active"
},
"tags": null,
"trial": {"type": "day",
"value": 0
},
"type": "all"
},
"product": null,
"status": "active",
"user": {"id": "jb1",
"name": "J.Black"
}
}