Hosted Payment Advanced Integration Manual

Hosted Payments Introduction

Hosted Payments allows web site developers to provide their customers with a secure and convenient way to submit payments or purchase products. This document describes the functionality that's included with Hosted Payments and how to link that functionality into your website.

To start using Hosted Payments, all you need is an account with PayJunction and a web page. Your web page does not need any scripting capability such as PHP, ASP or Python although you can certainly merge such dynamic scripting with this solution.

How does the Hosted Payments work?

Hosted Payments works by directing your customer to our secure checkout. Simply embed some HTML on your web pages to enable this functionality.

There are two different techniques that can be used...

One technique is to sprinkle your website with payment buttons (i.e. HTML) that allows your customers to add individual items to their cart. Once they’re done picking out items, they can click on a checkout button (i.e. HTML) to pay for the items they’ve chosen.

The second technique immediately sends your customers to your shop’s checkout screen with an amount to charge them already specified. This essentially collapses all the different steps of the first technique into one click. Instead of adding an item and then clicking to checkout at a later point, the customer adds an item and checks out immediately. This second technique is useful for sites that have their own shopping carts or that only have a single item to offer (like a payment or donation).

Demo account for development and testing

PayJunction provides a demo/sandbox account. You can track test transactions by logging into http://www.PayJunctionLabs.com.

Submitting Test Transactions

Transactions that are submitted via the test URL while using the test Store ID will be sent to the PayJunction sandbox (Demo Virtual Terminal) which can be accessed via http://www.PayJunctionLabs.com (see above section)

Post URL for testing purposes:

https://www.payjunctionLABS.com/trinity/quickshop/add_to_cart.action

Store ID for testing purposes:

pj-qs-01

Example HTML for Test Button:

 <form action="https://www.payjunctionlabs.com/trinity/quickshop/add_to_cart.action" method="POST">
  <input type="hidden" name="store" value="pj-qs-01">
  <input type="hidden" name="need_to_ship" value="yes">
  <input type="hidden" name="need_to_tax" value="yes">
  <input type="hidden" name="quantity" value="1">
  <input type="hidden" name="identifier" value="Online Order">
  <input type="hidden" name="description" value="A very nice widget.">
  <input type="hidden" name="price" value="50.00">
  <input type="submit" value="Add to Cart">
</form>

Test card information

Transactions ran on the sandbox account go through a test processor, so there is no need to void or otherwise cancel transactions.

However, to avoid using a live card, please use the following test card processing data:

Test Credit Card Numbers:

 
Visa:
4444 3333 2222 1111
4111 1111 1111 1111
4242 4242 4242 4242
Mastercard:
5105 1051 0510 5100
5555 5555 5555 4444
2223 0000 4840 0011
Amex:
3714 496353 98431
3434 343434 34343
3782 822463 10005
Discover:
6011 1111 1111 1117
6011 0004 0000 0000
6011 0009 9013 9424
Diner Club:
3614 890064 7913
3670 010200 0000
3056 930902 5904
JCB:
3566 1111 1111 1113
3528 0007 0000 0000
3530 1113 3330 0000

Test Expiration Date:
Any Expiration Month and Year in the Future. For example:

01/25

Test Address:

1903 Test St 

Test Zip Code:

93101

Test CVV:

999

Test Amount:

$2.00 or more

Transactions ran for an amount between $0.00 and $1.99 will result in a decline.

Submitting Live Transactions

Transactions that are submitted via the live URL will be sent to your Live PayJunction account which can be accessed via http://www.PayJunction.com

Post URL for testing purposes:

https://www.payjunction.com/trinity/quickshop/add_to_cart.action

Store ID (i.e. Shop):

1. Go to More, then select Hosted Payments.
   
2. Copy the Shop Name (i.e. Store ID) that you would like to use.
3. If you do not have any existing Shops, or you would like to create a new one, click New Shop on the top-right of the screen.
   

Example HTML for Live Button:

 <form action="https://www.payjunction.com/trinity/quickshop/add_to_cart.action" method="POST">
  <input type="hidden" name="store" value="YOUR-STORE-ID">
  <input type="hidden" name="need_to_ship" value="yes">
  <input type="hidden" name="need_to_tax" value="yes">
  <input type="hidden" name="quantity" value="1">
  <input type="hidden" name="identifier" value="Online Order">
  <input type="hidden" name="description" value="A very nice widget.">
  <input type="hidden" name="price" value="50.00">
  <input type="submit" value="Add to Cart">
</form>

How do customers add products to the cart?

You need to include an HTML button on your web page.

Here is a full HTML example; this example will add one Widget that costs $50.00 to the customer's shopping cart:

<form action="https://www.payjunctionlabs.com/trinity/quickshop/add_to_cart.action" method="POST">
  <input type="hidden" name="store" value="pj-qs-01">
  <input type="hidden" name="need_to_ship" value="yes">
  <input type="hidden" name="need_to_tax" value="yes">
  <input type="hidden" name="quantity" value="1">
  <input type="hidden" name="identifier" value="Online Order">
  <input type="hidden" name="description" value="A very nice widget.">
  <input type="hidden" name="price" value="50.00">
  <input type="submit" value="Add to Cart">
</form>

Notice that there's several fields that describe the product, supply the price, give the quantity to add, etc.

The above HTML will result in an Add To Cart button that will look like this:

When the button is clicked, the item will be added to the Cart:

At this point, the customer can click Checkout to pay, or they can return to your website to continue shopping. If the customer is ready to pay, PayJunction will also handle the collection of payment.

How can customer's see the items in their shopping cart?

Simply create a View Cart HTML button on your web page that points to PayJunction’s secure shopping cart site.

The URL to show the shopping cart screen is:

https://www.payjunction.com/trinity/quickshop/view_cart_init.action

The only requirement for these pages is that you supply the Store ID.

HTML form example for the view-shopping-cart page:

<form method="POST"action="https://www.payjunction.com/trinity/quickshop/view_cart_init.action">
   <input type="hidden" name="store" value="YOUR-STORE-ID">
   <input type="submit" name="" value="Show Shopping Cart">
</form>

HTML link example:

<a href="https://www.payjunction.com/trinity/quickshop/view_cart_init.action?store=YOUR-STORE-ID">Show Shopping Cart</a>

How can customers get to the check-out screen?

Simply create a Checkout HTML button on your web page that points to PayJunction’s secure shopping cart site.

The URL to show the checkout screen is:

https://www.payjunction.com/trinity/quickshop/check_out_init.action

The only requirement for these pages is that you supply the Store ID.

HTML form example for the checkout page:

<form method="POST"action="https://www.payjunction.com/trinity/quickshop/check_out_init.action">
   <input type="hidden" name="store" value="YOUR-STORE-ID">
   <input type="submit" name="" value="Checkout">
</form>

HTML link example:

<a href="https://www.payjunction.com/trinity/quickshop/check_out_init.action?store=YOUR-STORE-ID">Checkout</a>

How to checkout immediately with an amount included

If you only have a single product to offer or already have an aggregate amount ready, you may want to let the customer check out without having to add a product to their shopping cart separately. To do this, you need to create a Snap Checkout HTML button.

URL for Snap Checkout:

https://www.payjunction.com/trinity/quickshop/add_to_cart_snap.action

Here is a HTML example:

<form action="https://www.payjunctionlabs.com/trinity/quickshop/add_to_cart_snap.action" method="POST">
  <input type="hidden" name="store" value="pj-qs-01">
  <input type="hidden" name="need_to_ship" value="yes">
  <input type="hidden" name="need_to_tax" value="yes">
  <input type="hidden" name="quantity" value="1">
  <input type="hidden" name="identifier" value="Online Payment">
  <input type="hidden" name="description" value="Balance Owed">
  <input type="hidden" name="price" value="50.00">
  <!—See below for additional fields you can include here --> 
  <input type="submit" value="Submit Payment">
</form>

Supported Fields for Hosted Payments

Below is a table with a full description of each of fields, what their purpose is, whether they are mandatory or not, and what format is appropriate for their values.

If you do not want to craft your buttons by hand or need help, there is an interactive button generator is available for you to use. Access the button generator by logging into PayJunction. Click on More, then Hosted Payments. Then select "Generate Hosted Payment" on the top-right of the screen. 

<form action="https://www.payjunctionlabs.com/trinity/quickshop/add_to_cart.action" method="POST">
  <input type="hidden" name="store" value="pj-qs-01">
  <input type="hidden" name="need_to_ship" value="yes">
  <input type="hidden" name="need_to_tax" value="yes">
  <input type="hidden" name="quantity" value="1">
  <input type="hidden" name="identifier" value="Online Payment">
  <input type="hidden" name="description" value="Balance Owed">
  <input type="hidden" name="price" value="50.00">
  <!—Customer First Name --> 
  <input type="hidden" name="billingFirstName" value="John">
  <!—Customer Last Name --> 
  <input type="hidden" name="billingLastName" value="Doe">
  <input type="submit" value="Submit Payment">
</form>

<form method="POST" action="https://www.payjunctionlabs.com/trinity/quickshop/add_to_cart_snap.action"> 
  <input type="hidden" name="store" value="pj-qs-01">
  <input type="hidden" name="need_to_ship" value="yes">
  <input type="hidden" name="need_to_tax" value="yes">
  <input type="hidden" name="quantity" value="1">
  <input type="hidden" name="identifier" value="Online Order">
  <input type="hidden" name="description" value="A very nice widget.">
  <input type="hidden" name="price" value="50.00">

  <!— relay --> 
    <input type="hidden" name="relay"value="http://www.yourwebsite.com/script_name"> 
  <!— end_relay >

  <input type="submit" name="" value="Submit Payment">
</form>

<form method="POST" action="https://www.payjunction.com/trinity/quickshop/add_to_cart_snap.action"> 
  <input type="hidden" name="store" value="pj-qs-01">
  <input type="hidden" name="need_to_ship" value="yes">
  <input type="hidden" name="need_to_tax" value="yes">
  <input type="hidden" name="quantity" value="1">
  <input type="hidden" name="identifier" value="Online Order">
  <input type="hidden" name="description" value="A very nice widget.">
  <input type="hidden" name="price" value="50.00">
 
 <!— relay --> 
   <input type="hidden" name="relay"value="http://www.yourwebsite.com/script_name"> 
 <!— end_relay >

 <!— check_out -->
   
  <input type="hidden" name="echo"value="id=20&CompanyName=PayJunction"> 
 <!— end_check_out >
 
 <!— snap_check_out -->
   <input type="hidden" name="id" value="20">
   <input type="hidden" name="CompanyName" value="PayJunction"> 
 <!— end_snap_check_out>


 <input type="submit" name="" value="Donate">
</form>

<input type="hidden" name="relay" value="http://www.yourwebsite.com/yourreceiptpage.cgi">
<input type="hidden" name="echo"value="order_number=20&coupon=Free+frisbee+with+order."> 

<input type="hidden" name="order_number" value="20">

<input type="hidden" name="coupon" value="Free frisbee with order.">