Knowledge Base: Hosted Signup Page

Chargify offers a hosted/white label signup page for all of our customers.

Each Product has its own hosted signup page page and unique URL. You can find the URLs for these pages on your product overview screen, as indicated in the following image:

Pre-populating Data

When linking to the hosted payment page, it is possible to have certain values pre-populated by passing parameters as a "application/x-www-form-urlencoded" encoded data set (this simply a normal query string for GET requests, and a normal form post for POST requests).

The available parameters are:

• first_name: Fills the value for the customer's "First name"
• last_name: Fills the value for the customer's "Last name"
• email: Fills the value for the customer's "Email address"
• reference: Sets a hidden field to supply a value for the customer's "reference" value (the unique identifier you use for the customer within your own application
• organization: Sets a hidden field to supply a value for the customer's organization name (not currently a visible form input element)
• billing_zip: Fills the value for the cardholder's "Billing ZIP code"

(For a description of how these attributes apply to the created customer and payment profile, please refer to the "Subscription Input Attributes" section of the Subscriptions API documentation.)

For example, accessing a hosted signup page URL with the following query string would generate the form pre-populated as shown below:

?first_name=John&last_name=Doe&email=john.doe@example.com&reference=1234

Return URL and parameters

When configuring a product, it is possible to specify a Return URL and Return parameters.

The Return URL is the URL that the user will be redirected to after a successful transaction. The Return parameters specify the data that will be passed back in the query string of the Return URL.

The available parameters are:

• subscription_id: The Chargify generated unique identifier for the subscription that was created
• customer_id: The Chargify generated unique identifier for the customer that was created
• customer_reference: Your unique reference if one was sent in the pre-populated data
• product_handle: The product API handle
• product_id: The Chargify generated unique identifier for the product

Return parameters are specified using a single brace around the name of the parameter and separated with an ampersand.

For example, a Return URL of:

http://example.com/callback

With these Return parameters:

subscription_id={subscription_id}&customer_reference={customer_reference}

Would result in the URL:

http://example.com/callback?subscription_id=1&customer_reference=1234

Note: Return parameters should not be considered authoritative. Granting irrevocable access to users based on these values is not advised. They should be considered hints until the user is verified via a secure API read.