developer_guide:developer_guide:hosted_checkout

Hosted Payment Pages

Hosted Payment Page URLs

The hosted payment page URL can be used in text links, buttons, or form posts. In all of these cases the URL will load a hosted payment page in the browser for your customer to checkout. Since we host the checkout you do not need to worry about PCI compliance headaches.

Here are the steps to find the URL for a subscription package:

  1. Log into the Merchant Center
  2. Click “View All” next to the “Subscription Packages” heading
  3. The hosted payment page URL is contained in the text box call “Hosted Payment Page URL
  4. To copy the URL simply click the mouse on the text box, right click, select “Copy”. You could also click keyboard shortcut “Ctrl + C”.
  5. Now that you have the URL you can paste it into links, buttons, or forms. You can also paste it directly into emails and marketing documents.

If you want to generate the URL in code you can use the following format:

https://www.subscriptionbridge.com/checkout/<LinkID>

Custom URLs

For branding reasons you may want to use a more personalized URL that better matches your company.

Sub Domain

You can use your “Store Key” (found on the Store Setting page in the Merchant Center) in your URL. For example, you can type https://storekey.subscriptionbridge.com.

Hosted Payment Page Options

Below is a list of all options available on the hosted payment pages. You can pass these values as hidden field in a form post, or via query string parameters in a link.

  • start_page: this lets you skip the details page and go directly to the payment page.
  • first_name: pre-fills customer first name
  • last_name: pre-fills customer last name
  • company: pre-fills the company
  • email: pre-fills the email
  • reference: your internal customer reference number
  • return_page: the path from root domain name and file name of the receipt page
  • custom: any details you want to pass through our system. This will be returned in all callbacks. It can be a string or array of values

Hosted Payment Page Sample Form

<form action="https://www.subscriptionbridge.com/checkout/LinkID" method="post">
     <input name="start_page" type="hidden" value="payment" /> 
     <input name="first_name" type="hidden" value="Jane" />
     <input name="last_name" type="hidden" value="Doe" />
     <input name="company" type="hidden" value="Early Impact, Inc." />
     <input name="email" type="hidden" value="test@earlyimpact.com" />
     <input name="reference" type="hidden" value="Remote Customer ID" />
     <input name="return_page" type="hidden" value="receipt.html" />
     <input name="custom" type="hidden" value="array of value for pass through" />

    
     <input type="image" name="submit" border="0" src="https://www.mystore.com/images/button.gif" alt="">  

</form>

Custom Receipt Page

If you want to use your own custom receipt page we can redirect the customer to your store after they checkout. There are many useful reasons to do so:

  • Add a Google tracking code to your receipt page
  • Post Checkout Tasks (e.g. creating software license keys)
  • Downloadable products
  • Membership (e.g. redirecting user to special member content)

The custom receipt is easy to implement. Just follow these simple steps:

  1. Log into the Merchant Center
  2. Click “Store Settings”
  3. Type your domain name into the “Store URL” field and “Save”. Be sure you type the full URL starting with “http”.
  4. Now that your store URL is saved you just need to add the “return_page” option to your form or link. See the sample form above.
  5. After checkout we will redirect the customer to the domain + path specified in the “return_page” field.

Note: You can use search engine friendly links or dynamic links in the “return_page” field.

Return Parameters

If you use your own customer receipt page we will send you a few parameters in the URL query string. You can use these parameters to create a nice receipt page.

Here is a list of parameters:

  • Guid: This is the subscription ID. It is used in subsequent calls and we recommend you save it to your database. For example, you can immediately call “GetSubscriptionDetailsRequest” to obtain more details about the subscription and customer, which can be used on the receipt page or saved to your database.
  • Email: The customers email
  • AmountPaid: The total purchase cost paid today… may differ from next billing cycle.
  • TransactionID: The transaction ID from the gateway
  • Custom: Your pass through values, such as internal customer ID, MPN, or SKU.
developer_guide/developer_guide/hosted_checkout.txt · Last modified: 2012/12/27 16:33 by matt