Trigger renewal before usage upload interval
Last updated: 27-Sep-2021
Rate this article:
Overview
Trigger the renewal for a pay-per-usage subscription even before the end of the usage upload interval. Once the API call is made, the subscription is marked as ready to renew, and a renewal will be attempted. If the first attempt is not successful, the renewal of the subscription will be attempted again based on the regular renewal schedule.
Request Parameters
Parameter | Type | Required | Description |
---|---|---|---|
sessionID | String | Required | Session identifier, the output of the Login method. Include sessionID into all your requests. 2Checkout throws an exception if the values are incorrect. The sessionID expires in 10 minutes. |
subscriptionReference | String | Required | Unique, system-generated subscription identifier. 2Checkout charges customers using the payment data attached to subscriptions. In the case of credit/debit cards, if customers update their payment information in MyAccount or if you update these details on behalf of your subscribers, the 2Checkout system uses the latest card info provided to charge subscription renewals. |
Request Sample
<?php
require ('PATH_TO_AUTH');
$subscriptionReference = 'YOUR_SUBSCRIPTION_REFERENCE';
try {
$success = $client->markUsageSubscriptionToRenewNow($sessionID, $subscriptionReference, $Days, $Price, $Currency);
}
catch (SoapFault $e) {
echo "Fault: " . $e->getMessage();
exit;
}
var_dump("Success", $success);
Response Parameters
Parameter | Type/Description |
---|---|
Boolean | true or false depending on whether or not the subscription was marked as ready to be renewed. The response does not reflect the success of the renewal attempt. |
Related articles
Rate this article: