Updating a subscription's billing and shipping email address

Learn how to update a subscription's billing and shipping email address.

Updating a subscription's billing and shipping email address is critical in ensuring that the shopper stays informed about their subscription details and receives all necessary communications. Whether it's a notification for a billing statement, shipping update, or any other important information, having the correct email address is vital. This guide will walk you through the simple steps to update a shopper's subscription billing and shipping email address using a POST request. Follow the instructions below to keep your subscription information up-to-date.

Updating the email addresses for subscriptions is crucial for several reasons:

  • Ensures effective communication: It guarantees that the shopper receives all essential notifications related to billing statements, shipping updates, or any other critical information about their subscription.

  • Avoids service interruptions: Keeping the email address updated helps prevent missed communications that could lead to service disruptions, such as failure to renew due to missed payment reminders.

  • Enhances customer experience: It ensures that customers are well-informed about their subscription status and any changes, promoting transparency and trust.

  • Facilitates account management: Updated contact information makes it easier for customers to manage their subscriptions and for businesses to provide timely support.

Therefore, maintaining current email addresses is vital for the customer's convenience and the business’s operational efficiency.

Send a POST /v1/subscriptions/{subscriptionId}/email request to the subscription's specific endpoint to update the subscription's billing and shipping email address. Here's how you can do it using curl:

curl --location --request POST 'https://api.digitalriver.com/v1/subscriptions/{subscriptionId}/email' \
--header 'Authorization: Basic  {Your_Access_Token}' \
...
--data-raw '{
  "emailAddress": "string"
}'

Replace {subscriptionId} with the actual ID of the subscription you want to update and {Your_Access_Token} with your authorization key. Refer to the Obtain API credentials topic for more information on your authorization key. Set "your_email@example.com" to the new email address you wish to use.

Upon success, you will receive a 200 Accepted response. See the Error codes for shopper APIs section if you get an error. The new plan will go into effect immediately.

Last updated