developer_guide:developer_guide:hosted_checkout

This is an old revision of the document!


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>

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.

developer_guide/developer_guide/hosted_checkout.1323837665.txt.gz · Last modified: 2011/12/12 23:00 (external edit)