Self Service Pages

Chargify includes the functionality to allow a subscriber to securely update their payment information online. We refer to this page as the self-service page.

Obtaining the Self-Service Page URL

There are a few ways for a Merchant to obtain the self service URL. Additionally, Chargify offers many ways to automatically distribute this secure URL to your subscribers.

You can view the Self-Service Page for a subscription directly from a subscriber’s page in the application. You’ll find the link to the Subscription’s Self-Service Page inside the actions menu in each table row.

Additionally, you can obtain the URL from the list of all of your subscribers, under the subscriptions tab. This URL is available in the mini-actions menu in your Subscriber list.

If you visit the Self-Service Page, you will be logged out of Chargify. A good rule of thumb is to open Self-Service Pages in Incognito-mode (Chrome) or a Private Window (Firefox).

Limitations and Blocks

Your subscriber can attempt to update their credit card a total of 7 times in one 24-hour period. After the 7th failure, they will be locked out of updating the card for the subscription. After midnight, this restriction will be lifted.

Automatically Update your Subscribers

It’s important to always have a valid credit card on file for a subscriber. For this reason alone, we offer the functionality inform a subscriber how they can automatically update their card.

The self-service page URL can be sent to your subscribers automatically in many of the automatically-generated emails Chargify offers to you.

Email Templates and Self-Service Pages

Add a URL to any of your Chargify-generated-emails to steer subscribers towards updating their cards when necessary.

A few examples include:

  • Settings –> Retries & Dunning -> Add Message. Include the URL in your dunning emails by adding `` in any of your messages.

  • Settings –> Emails –> Edit Template. You can include the URL in your email templates by adding `` in any of your messages.

For a full list of what dynamic variables are available, please view our documentation here.

A merchant can manually send a link to the email addresses associated with the subscription by selecting “Email Customer to Request Payment Update”. This email can be customized as needed.

Updating Payment Information via the Billing Portal

Customers may also update their payment information via the Billing Portal. For more information all about the Billing Portal, please visit our our introduction to the Billing Portal. Self-service pages act as an alternative way for subscribers to update their cards if merchants elect to not enable the Billing Portal.

Example Self-Service Page

Below is an example of a Self-Service page that a customer can use to update their payment method. A subscriber can securely enter all of their information and select “Update”. This new card will be the active payment method on file for the subscription.

PayPal and Self-Service Pages

If you are using a gateway that uses PayPal, such as Braintree, a self-service page can be used to switch from a credit card payment to PayPal. A subscriber can select “PayPal” from the Payment Method options.

The subscriber will be directed towards a PayPal popup window that will allow them to securely enter their PayPal credentials.

Requesting Billing Address on Self-Service Page

A few gateways require that all payment methods contain full billing information. On a product-by-product basis, you can enable the option to collect bull billing information.

You can accomplish this by editing any of the products in your Chargify Site. Under the Billing Address Settings for an individual product, select “Request on Self-Service Page”. This setting will force a full address to be collected on your Self-Service Page.

Public Page Translations/Internationalization (i18n)

The Public Pages are only offered in English at this time. If you would like to add translations to page content, you may do so by writing JavaScript that replaces on-page content with your own content via Custom JavaScript.

Translating Javascript Generated Content

Even though you can translate on-page content by replacing text on the page, there is still an issue where you will not have access to content that we generate via Javascript and add to the page later. Examples of this kind of content are:

  • The alert box that pops up when the Terms & Conditions are not acknowledged
  • The label on the submit button that changes as a result of a click (i.e. from “Submit” to “Processing…”)

We have provided a mechanism for you to add translations for this javascript-generated content. To your Custom Javascript, you may add translations by extending chargifyHostedPageDictionary. :

$.extend(chargifyHostedPageDictionary, {
  // The alert pop up when agreement to terms is required but not checked:
  'alert.must-agree-to-terms':         'You must agree to the Terms and Conditions',
  //
  // The default value for the Billing/Shipping State selector after choosing a new country:
  'form.address-state.blank-label':    'Please select',
  //
  // The replacement value for the submit button text once it is clicked:
  'form.submit-button.disabled-label': 'Processing...'
});

Shown above is the default text from our default dictionary. If I wanted to translate the content to another language, say “Pirate”, I could: :

$.extend(chargifyHostedPageDictionary, {
  "alert.must-agree-to-terms": "Arr matey, agree to mine terms or walk the plank",
  'form.address-state.blank-label':    'Select yer state, swashbuckler',
  'form.submit-button.disabled-label': 'Shiver your timbers...'
});