This will allow you to change the status of a particular recurring payment subscription from one particular lead. The possible statuses are...
- Active
- Cancelled
- Terminated: meaning payment plans where all scheduled payments have already been paid
- Paused: the subscription is technically active but no further payment will be processed until you "unpause" it back to Active (see below)
- PayPal subscriptions cannot be edited, since Paypal manages the subscriptions in-house and they do not allow modifications from external sources.
- Payment subscriptions with status Cancelled or Terminated cannot be changed since they are not technically active anymore.
Type | Parameters | Values |
POST | cmd* | modify_subscription_status |
POST | subscription_id* | integer |
POST | subscription_status_modification* | Posible values are "cancel", "unpause", "pause" |
* Required fields Here is an example:
'actions' => [ '0' => [ 'cmd' => 'modify_subscription_status', 'subscription_id' => 7373847, 'subscription_status_modification' => 'pause', ] ]
Success message:
{ "status":"Success", "actions":[ { "modify_subscription_status":{ "status":"Success", "message":"Subscription modified", "type":"115" } } ] }
Error Cases:
Type Number | Message | Cause |
248 | Subscription doesn't exist |
|
274 | Wrong status |
|
284 | Paypal transactions cannot be modified |
|
275 | Subscriptions cancelled or terminated cannot be updated |
|
252 | Subscription already cancelled |
|
267 | Cancellation has failed |
|
{ "status": "Error", "message": "Subscription doesn't exist", "type": 248 }