post https://api.fastspring.com/subscriptions//convert
Use this endpoint to create a session to be used by the buyer in order to reactivate a trial subscriptions that is in time to be converted to a paid subscription, subject to meeting certain pre-conditions:
Preconditions
- Trial subscription without payment
- Deactivated because of trial period ended and no payment method was added
- Conversion period is still active
- Conversion is enabled
- Deactivation date + conversion days <= API call date
Optional Payload
{
"coupon": "ten-off"
}
Error Responses
You may receive one of the following error responses in case of validation failures.
{
"action": "subscription.convert",
"result": "error",
"error": {
"subscription.convert": "Unable to find subscription."
}
}
{
"action": "subscription.convert",
"result": "error",
"error": {
"subscription.convert": "Unable to reactivate. Please specify a subscription where payment was not collected."
}
}
{
"action": "subscription.convert",
"result": "error",
"error": {
"subscription.convert": "Only deactivated subscriptions can be reactivated."
}
}
{
"action": "subscription.convert",
"result": "error",
"error": {
"subscription.convert": "Only canceled subscriptions can be reactivated."
}
}
{
"action": "subscription.convert",
"result": "error",
"error": {
"subscription.convert": "Reactivation is not allowed on the subscription, or the reactivation period has passed."
}
}