Abonnement aktualisieren

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

Aktualisiert ein Abonnement, indem entweder dessen Status (active, canceled oder non_renewing) geändert oder das nächste Abrechnungsdatum zeitlich verschoben wird.

SecuritybasicAuth

Request

path Parameters

project_id required	integer Projekt-ID.
user_id required	string Benutzer-ID.
subscription_id required	integer Abonnement-ID.

Request Body schema: application/json

cancel_subscription_payment

boolean

Ist true festgelegt, so wird die letzte, für dieses Abonnement getätigte Zahlung zurückerstattet. Funktioniert nur dann, wenn zugleich der Status auf canceled gesetzt ist.

status

string

Status.

Enum: "active" "canceled" "non_renewing"

object

Zeitliche Zurückstellung der Abrechnung.

type	string Einheit für die Abrechnungszeit. Möglich sind `day` oder `month`. Enum: "day" "month"
value	string Anzahl der Zeiteinheiten, um die die Abrechnung verschoben werden soll. Der Wert hängt vom Parametertyp ab, möglich sind: - von 1 bis 366, sofern für `type` `day` festgelegt ist - von 1 bis 12, sofern für `type` `month` festgelegt ist

user_id

string

Benutzer-ID.

object

collaborator_id

string

Kooperationspartner-ID – Influencer- oder Affiliate-Netzwerk-Kennung. Diese finden Sie im Kundenportal unter Partner Network > Influencer.

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"
}
}