Using the Expired Card Optimizer
Learn how to use the Expired Card Optimizer (ECO) for a third-party subscription engine renewal orders.
Last updated
Was this helpful?
Learn how to use the Expired Card Optimizer (ECO) for a third-party subscription engine renewal orders.
Last updated
Was this helpful?
The Expired Card Optimizer (ECO) is a Billing Optimization feature used to optimize the subscription renewal for credit cards only. It is designed to renew orders for the Digital River subscription engine as described in Providing subscription information. However, as described below, you can use the ECO to renew subscriptions for a third-party subscription engine (a non-Digital River subscription engine).
To use ECO to renew a subscription that does not use the Digital River subscription engine, insert both the subscriptionInfo
and billingOptimization
in the lineItem
array when you create a cart using for a third-party subscription engine.
Only provide the information used in this example to renew orders when not using the Digital River subscription engine. An expired credit card does not occur during the initial acquisition, so this information is not required during the initial acquisition.
subscriptionInfo
The subscription information should indicate the order uses a third-party subscription engine. Note that Digital River does not validate data from non-Digital River subscription engines.
billingOptimization
To trigger an ECO, provide the following subscription information under billingOptimization
:
subscriptionId
–The subscription's unique identifier. The subscriptionId
is a string of up to 32 characters.
segmentId
–The unique segment identifier for each renewal term must be unique across all of Digital River's client's subscriptions. The segmentId
is a string of up to 32 characters.
The segment identifier value changes after each renewal attempt and increments upwards (for example, 7654321seg2
, 7654321seg3
).
You can format the segmentId
as follows:
"segmentId": "{{subscriptionId}}"+{{segmentCount}}",
Where the value for subscriptionId
is a string of up to 32 characters.
renewalAttemptNumber
–The number of billing attempts for the current renewal. Then the value resets to 1
after each successful renewal. At the time of the first renewal attempt, ECO generates an incremented expiration date schedule that lives in a Billing Optimization table.
The renewal orders for a Digital River subscription provide all the necessary information. Therefore, you do not need to insert this information manually.