PayByCheck | Payment Interface HTML Instructions

Pop-Up Payment Interface:

The Pop-Up Interface uses an inline Javascript onClick event:
onClick =
"window.open('https://PayByCheck.com/lite/?id=00000000&i=Special%20Purchase&a=19.95&m=Special%20Order', 'console','scrollbar=0, toolbar=0, resizable=0, menubar=0, status=1');"
Example: using an image button
<img src = "http://images.paybycheck.com/cart/buynowgrn.gif" border="0" align="absmiddle" onClick = "window.open ('https://PayByCheck.com/lite/?id=00000000&i=Special%20Purchase&a=19.95&m=Special%20Order', 'console', 'scrollbar=0, toolbar=0, resizable=0, menubar=0, status=1');">
The Pop-Up Payment Interface does not currently integrate with the ITI/PayByCheck Shopping Cart.

Single Payments and 3rd-Party Shopping Carts

Creating the Link

To use PayByCheck on your sites you need to create links to your check payment form on our secure servers. All fields that are required in the check form can be pre-populated by your scripts. The PayByCheck gateway is located at:

https://PayByCheck.com/

Specifying Merchant ID

Now you have to insert a variable designating the merchant to whom the payment is going to. Just add your PayByCheck Account ID to the end of the link:

?id=00000000
(Replace the zeros with your PayByCheck Account ID.)

Your link should now look like this:
https://paybycheck.com/?id=00000000

If you click on the link above you will see a sample check payment form with the field for the dollar amount empty. Leaving the dollar amount empty works fine for some applications.

Specifying Payment Amount

If you want to include the dollar amount for your customer, you simply need to insert the variable designating the amount to your link.

&a=169.95

Now the link should look like this:
https://PayByCheck.com/?id=00000000&a=169.95

Specifying order number, product purchased, etc.

You can include the variable named "item" to designate your order numbers, the product purchased, etc.

&item=Color+Monitor

The Item in this case is a "Color Monitor". (Since the link URL cannot have any spaces, you will need to replace any spaces in the Item value with "+" as in the example above.)

https://PayByCheck.com/?id=00000000&a=169.95&item=Color+Monitor

Summary

You can have as many links with different dollar amounts as you desire.

Following is a complete list of the variable names and their definitions. These variables can be optionally posted from your order page, forms, or shopping cart program. Variables are posted to https://PayByCheck.com along with the following required and optional variables.

Required Variables

id - ITI or PayByCheck Account ID, 5 - 50 characters

Optional Variables

name - customer's full name, 5 - 50 characters
address1 - street address, 5 - 50 characters
city - city name, 2 - 30 characters
state - state abbreviation, 2 characters
zip - postal code, 5 - 10 characters
phone - phone number, 10 - 20 characters
email - email address, must be valid format "user@host.top", > 5 characters, top must be either 2 or 3 characters, max 100 characters
a - the amount of the transaction, decimal, 0.01 - 999999.99
item - a non editable hidden field for merchant use only, max 100 characters. The contents of the item variable are stored with each transaction in the Utilities, included in customer and merchant notfications for APPROVED transactions, but NOT included in the customer notifications for DECLINED transactions.
memo - an editable default memo on the check, max 100 characters. The contents of the item variable are stored with each transaction in the Utilities, included in customer and merchant notifications for APPROVED transactions, but NOT included in the customer notifications for DECLINED transactions.
texture - the background texture of the check, 0 thru 29
design - the design of the check - 0 or 1
s - the URL that a customer is redirected after an Approved transaction
f - the URL that a customer is redirected after a Declined transaction
cur - currency of payment, default is USD, 3 characters
lock - set value to make the passed values for name, address1, city, state, zip, phone number, and email non-editable by customer
sessionid - pass a user-defined variable (user id, session number, etc.) that will be included unchanged in the success and fail URLs

Full HTML Example

The following HTML uses the variables listed above to produce a button which will direct the customer to the payment form:

Variables Passed Back To Your Script

The following variables can be passed back to your script when using the standard interface and the standard variables list:

item - item description for transaction
ref - PayByCheck transaction reference number
email - customer's email address
a - amount of transaction
sessionid - user-defined session id variable

The "item" variable is (or should be) initially set by your script when initiating a transaction, so it can be a string of anything you need to pass through. The pass is accomplished by setting the following variables and appending them to your "transaction refresh URLs" i.e. the addresses your customers go to after conducting a transaction:

ITEM
REF
EMAIL
AMOUNT
SESSIONID

For example, if your "transaction accepted refresh URL" is http://www.foo.com and you want the item value passed to that URL with the variable re-named "myvariable" you would do this:

https://PayByCheck.com/?id=00000000&item=Dog%20Food&a=5&s=http%3A%2F%2Fwww.foo.com?myvariable%3DITEM

Your refresh URLs will probably require URL encoding depending on the reference situation and your scripting language. Trial and error this one.

You can reference ITEM, REF, EMAIL, and AMOUNT in the refresh URL in the PayByCheck Merchant Utilities account settings *or* use the "URL" variable as demonstrated above.

Using the PayByCheck Free Shopping Cart

You can also make links, buttons, and forms which use PayByCheck's built-in shopping cart. With only a little knowledge of HTML you can have your products up and ready to sell. If you need automatic layout and inventory or database type features, you may want look at some the third party carts on our approved shopping carts page.

In order to use our cart, you must first create your product pages as you would like them to appear for your customers. Then you can assign links to product pictures, descriptions or graphic buttons following the link directions below.

Standard HTML Link

(opens shopping cart in new window, Javascript version (instructions below this) opens small cart window)

The basic link should look like this: (Replace the zeros with your PayByCheck Account ID.)

https://PayByCheck.com/cart/?id=00000000

If you click on the link above you will see a sample shopping cart page. Your company name will be in the heading when you use your Account ID instead of the 0's.

Including Variables
You also need to include the price, quantity and item variables to designate the product purchased. The Item in this case is a "Pet Rock" with a price of 99.95 and quantitiy of only 1 item.

Now your link should look like this:

https://PayByCheck.com/cart/?id=00000000&price=99.95&quantity=1&item=Pet+Rock

Note: Since the link URL cannot have any spaces, you will need to replace any spaces in the Item description value with "+" as in the example above. These will convert to spaces in the cart window.

Required variables:

(see corresponding color coded link below, only colored items should change, everything else stays the same.)

id - your ITI or PayByCheck account id, 5 - 50 characters
price - the price of each item, decimal format e.g. 0.01
quantity - number of items to buy, if not specified defaults to 1
item - a non editable hidden field for merchant use, max 100 characters. The contents of the item variable are displayed in the customer's shopping cart, stored with each transaction in the Utilities, included in customer and merchant notifications for APPROVED transactions, but NOT included in the customer notifications for DECLINED transactions.

https://PayByCheck.com/cart/?id=00000000&price=99.95&quantity=1&item=Pet+Rock

The following HTML uses the variables listed above to produce a button which will direct the customer to the shopping cart:

Contents