Amending a Subscription

Subscriptions store customer details using a Token Management Service (TMS) token and have an assigned payment plan. Subscriptions consist of this information:
Subscription code
Use the
subscriptionInformation.code
 REST API field to specify an amended value.
Subscription name
Use the
subscriptionInformation.name
 REST API field to specify an amended value.
Start date
Use the
subscriptionInformation.startDate
 REST API field to specify an amended value.
Token Management Service (TMS) token
You cannot change this information.
Plan: standard or one-time
A
standard plan
 is created and stored within the recurring billing service for re-use. You can assign these plans to multiple subscriptions.
A
one-time plan
 is created specifically for a single subscription, and you create the plan when you create the subscription. A one-time plan does not include a plan code, plan name, or plan description.
IMPORTANT
The subscription information that you can amend depends on the status of the subscription. Note the limitations described in in the paragraphs that follow.
IMPORTANT
When you change the plan ID (
subscriptionInformation.planId
 field) assigned to a subscription, the first payment is processed immediately. If proration is required after the change, it must be managed outside of the recurring billing service.

Basic Steps

Follow these steps to amend a subscription.
  1. Create the request message with the API fields that contain new values.
  2. Send the request message to one of these endpoints. In the endpoint path, replace the
    {id}
     portion of the URL with the subscription ID (
    id
    ) that you received when you retrieved a list of subscriptions:
    • Production:
      PATCH https://api.cybersource.com/rbs/v1/subscriptions/{id}
    • Test:
      PATCH https://apitest.cybersource.test.com/rbs/v1/subscriptions/{id}
  3. Verify the response messages to make sure that the request was successful. A 200-level HTTP response code indicates success.