Update Customer Contact Information

!-- this is the topic to be merged - look at this again -->

The following is how you can enable customers to update their contact information and maintain their subscription with your product. By allowing customers to take control of their personal data using traditional “My Account” functionality, you not only free up your customer service and tech support teams for more pressing tasks, but your customers are also more likely to remain subscribers to your product.

To enable customers to change their contact information themselves, you can integrate the following flow into your system:

Preconditions and Considerations

  • The customer has a subscription.
  • At least one of the subscription products has the status Active.
  • The ContactType parameter is required. Valid values are:
  1. LicenseeContact (or 0 for JSON)
  2. BillingContact (or 1 for JSON)
  3. DeliveryContact (or 2 for JSON)

Description

  1. On July 1st, you email a customer to follow up on the purchase of the subscription product CloudMax Enterprise. The email contains the option, "Click here to update your customer contact information for your Cloud Max Enterprise subscription."
  2. The customer clicks the link and is redirected to the Manage my Cloud Max Enterprise Contacts page on your website. The page has options for the customer to enter the following types of information:
  • Billing contact
  • Delivery contact
  • Licensee contact
  1. The customer enters information for the billing contact and clicks Submit. The page uses the Update Contact API endpoint to update the customer's billing information in the Cleverbridge platform.

To achieve this particular use case, set the parameters in the Update Contact API call to the values listed in the table.

ParameterSet to Value
SubscriptionIdThe unique identifier for the subscription.
ContactSee documentation at the Update Contact for complete information
ContactTypeBilling

Illustration

sub bill change props update customer contact

Step 1: Change contact information

If a customer would like to change their personal information (e.g., a new email address), call the Update Contact API endpoint. In the API call, do the following:

  • Add the customer's CountryId and LanguageId to the Contact argument, as well as the contact information that they would like to update or change.
  • Submit the ContactType to which you would like the changes to be applied.
  • curl --request POST \
      --url https://rest.cleverbridge.com/subscription/updatecontact \
      --header 'accept: application/json' \
      --header 'content-type: application/json' \
      --header 'authorization: Basic xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx' \
      --data '{
        "Contact":{
          "CountryId":"US",
          "Email":"[email protected]",
          "LanguageId":"en"
        },
        "ContactType":"BillingContact"
      }'
    

Step 2: Cleverbridge sends you a CustomerProfileUpdateNotification

Cleverbridge sends you a CustomerProfileUpdateNotification, which contains information that allows you to update your local ecosystem (CRM, ERP, etc.). It includes:

  • internalCustomer: your unique customer identifier
  • the contact information that the customer updated
{
  "meta": {
    "type": "CustomerProfileUpdateNotification",
    "date": "2019-03-19T14:47:34.857671",
    "schemaUrl": "https://www.cleverbridge.com/JsonNotificationSchemas/CustomerProfileUpdateNotification"
  },
  "customer": {
    "customerId: "123456789",
    "internalCustomer": "UUID-YOUR-UNIQUE-ID-1234-5678",
    "billingContact": {
      ...
      "email": "[email protected]"
    },
    ...
    }
  }
}