Subscription management and recurring billing solutions
SubscriptionBridge
 

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

developer_guide:developer_guide:hosted_checkout [2012/12/27 16:33]
matt [Custom URLs]
developer_guide:developer_guide:hosted_checkout [2012/12/27 13:33] (current)
Line 1: Line 1:
-====== Hosted Payment Pages ====== +====== Hosted Payment Pages ======  
- +  
-===== Hosted Payment Page URLs ===== +===== 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. +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: +Here are the steps to find the URL for a subscription package:  
- +  
-  - Log into the Merchant Center +  - Log into the Merchant Center  
-  - Click "View All" next to the "Subscription Packages" heading +  - Click "View All" next to the "Subscription Packages" heading  
-  - The hosted payment page URL is contained in the text box call "Hosted Payment Page URL" +  - The hosted payment page URL is contained in the text box call "Hosted Payment Page URL"  
-  - To copy the URL simply click the mouse on the text box, right click, select "Copy". You could also click keyboard shortcut "Ctrl + C". +  - To copy the URL simply click the mouse on the text box, right click, select "Copy". You could also click keyboard shortcut "Ctrl + C".  
-  - 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. +  - 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: +If you want to generate the URL in code you can use the following format:  
- +  
-https://www.subscriptionbridge.com/checkout/<LinkID> +https://www.subscriptionbridge.com/checkout/<LinkID>  
- +  
-==== Custom URLs ==== +==== Custom URLs ====  
-For branding reasons you may want to use a more personalized URL that better matches your company. +For branding reasons you may want to use a more personalized URL that better matches your company.  
- +  
-=== Sub Domain === +=== 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. +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 ===== +===== 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. +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. +  * start_page: this lets you skip the details page and go directly to the payment page.  
-  * first_name: pre-fills customer first name +  * first_name: pre-fills customer first name  
-  * last_name: pre-fills customer last name +  * last_name: pre-fills customer last name  
-  * company: pre-fills the company +  * company: pre-fills the company  
-  * email: pre-fills the email +  * email: pre-fills the email  
-  * reference: your internal customer reference number +  * reference: your internal customer reference number  
-  * return_page: the path from root domain name and file name of the receipt page +  * 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 +  * 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 ===== +===== Hosted Payment Page Sample Form =====  
- +  
-<code> +<code>  
- +  
-<form action="https://www.subscriptionbridge.com/checkout/LinkID" method="post"> +<form action="https://www.subscriptionbridge.com/checkout/LinkID" method="post">  
-     <input name="start_page" type="hidden" value="payment" />  +     <input name="start_page" type="hidden" value="payment" />   
-     <input name="first_name" type="hidden" value="Jane" /> +     <input name="first_name" type="hidden" value="Jane" />  
-     <input name="last_name" type="hidden" value="Doe" /> +     <input name="last_name" type="hidden" value="Doe" />  
-     <input name="company" type="hidden" value="Early Impact, Inc." /> +     <input name="company" type="hidden" value="Early Impact, Inc." />  
-     <input name="email" type="hidden" value="test@earlyimpact.com" /> +     <input name="email" type="hidden" value="test@earlyimpact.com" />  
-     <input name="reference" type="hidden" value="Remote Customer ID" /> +     <input name="reference" type="hidden" value="Remote Customer ID" />  
-     <input name="return_page" type="hidden" value="receipt.html" /> +     <input name="return_page" type="hidden" value="receipt.html" />  
-     <input name="custom" type="hidden" value="array of value for pass through" /> +     <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="">   +     <input type="image" name="submit" border="0" src="https://www.mystore.com/images/button.gif" alt="">    
- +  
-</form> +</form>  
- +  
- +  
-</code> +</code>  
- +  
-===== Custom Receipt Page ===== +===== 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: +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 +  * Add a Google tracking code to your receipt page  
-  * Post Checkout Tasks (e.g. creating software license keys) +  * Post Checkout Tasks (e.g. creating software license keys)  
-  * Downloadable products  +  * Downloadable products   
-  * Membership (e.g. redirecting user to special member content) +  * Membership (e.g. redirecting user to special member content)  
- +  
-The custom receipt is easy to implement. Just follow these simple steps: +The custom receipt is easy to implement. Just follow these simple steps:  
- +  
-  - Log into the Merchant Center +  - Log into the Merchant Center  
-  - Click "Store Settings" +  - Click "Store Settings"  
-  - Type your domain name into the "Store URL" field and "Save". Be sure you type the full URL starting with "http". +  - Type your domain name into the "Store URL" field and "Save". Be sure you type the full URL starting with "http".  
-  - 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. +  - 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.  
-  - After checkout we will redirect the customer to the domain + path specified in the "return_page" field.   +  - 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. +Note: You can use search engine friendly links or dynamic links in the "return_page" field.  
- +  
- +  
-===== Return Parameters ===== +===== 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. +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: +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 "[[developer_guide:call_reference:getsubscriptiondetailsrequest|GetSubscriptionDetailsRequest]]" to obtain more details about the subscription and customer, which can be used on the receipt page or saved to your database. +  * 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 "[[developer_guide:call_reference:getsubscriptiondetailsrequest|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 +  * Email: The customers email  
-  * AmountPaid:  The total purchase cost paid today... may differ from next billing cycle. +  * AmountPaid:  The total purchase cost paid today... may differ from next billing cycle.  
-  * TransactionID: The transaction ID from the gateway +  * TransactionID: The transaction ID from the gateway  
-  * Custom:  Your pass through values, such as internal customer ID, MPN, or SKU. +  * Custom:  Your pass through values, such as internal customer ID, MPN, or SKU.  
- +  
- +  
- +  
 +
  
C:/Domains/subscrip/wiki.subscriptionbridge.com/wwwroot/sbdata10/pages/developer_guide/developer_guide/hosted_checkout.txt · Last modified: 2012/12/27 13:33 (external edit)
 


Contact us for more information, or head over to the free trial sign-up form to give SubscriptionBridge a try!   Sign Up Free