![]() |
Integrating ChecksByNet Into Your Web Site |
Now you can safely accept checks on your web page, have the checks approved and available for printing, then deliver your service or product immediately. (Available only for United States of America checking accounts with U.S. funds)
CrossCheck offers two programs to choose from that allow you to do this:
ScriptURL Program
For simple development purposes, you can use our ScriptURL program. With this, you will "link over" your customer from your web page to http://cross.checksbynet.com so they may write a check to you and return to your web site. At the same time you are sending the customer to us, you may tell us where you want to send the customer once they finish writing the check. When the customer returns back to you, we will include the status of the transaction. ChecksByNet takes care of the error checking on the transaction and lets you know whether the check receives an approval or not. When the customer finishes writing the check, we will send them to the URL you specify along with the status of the transaction.
Response Program
With ChecksByNets Response program, you can integrate ChecksByNet fully into your web site by posting all the check information your customer submits to http://cross.checksbynet.com in one full URL. By doing this, you will need to check for any errors when asking for the check information. When posting the check information to our Response Program, we will return a response, or multiple responses for a result. Depending on the response, your script will check the responses and inform your customer that the transaction was successful or provide information regarding the status of their entry. The Response Program is appropriate for merchants that do not want their customers to "link over" to a different web site and/or want the continuity of the design of their web site.
![]() |
ChecksByNet ScriptURL Program |
ChecksByNet can now be utilized to inform your script or program when a customers check receives an approval or decline from CrossCheck. At the same time, you can direct a customer to any URL, depending on the response received from CrossCheck. By directing your customer to us, we will take care of all the error checking while your customer is writing a check. You need to place the URL to ChecksByNet on your web page, and specify a URL after the "ScriptURL" parameter at the end.
The following are instructions for setting up ScriptURL:
https://cross.checksbynet.com/consumer/checks.asp?paytoid=###########&scriptURL=URL
Optional: After "?paytoid=" you can specify "&gather=ON". This will send all the information the customer filled out to the scriptURL you specify, along with the response code.
Example of HTML code
Must be entered within the body of html:
<a
href="https://cross.checksbynet.com/consumer/checks.asp?paytoid=###########&scriptURL=https://cross.checksbynet.com/answer.asp?ordernumber=12345">
<img
src="http://www.checksbynet.com/media/littlechecks.gif">
</a>
ChecksByNet will append one of the following responses you specified for ScriptURL:
Response |
Description |
| &response=RSP0000, | Approved -Will include a 6 digit approval number after the response. |
| &response=RSP0001, | Check has been Declined. |
| If your account is setup as "Verification Only" with CrossCheck: | |
| &response=RSP0002, | Recommended |
| &response=RSP0003, | Not Recommended |
| &response=RSP0020, | Duplicate check has been approved previously. |
| &response=RSP0051, | Invalid Merchant |
| &response=RSP9999, | Unable to connect to CrossChecks server. |
| &response=RSP0010, | Test Transaction Complete |
When the customer completes writing their check, they will need to agree to our authorization agreement before directing them to the ScriptURL. Once the customer clicks on the "I Agree" button, we will direct the customer to the "ScriptURL" you specified, and append a response code to it. You can check for only "RSP0000," within the query string, and provide the customer your product or service immediately. If you do not receive "RSP0000," such as "RSP0001," please inform your customer what to do to find out why their check was not approved by using our decline information, then you may provide your customer a different payment method.
Look at the following example at: http://cross.checksbynet.com/responsecheck.htm
Use the example above for the "ScriptURL" field on this page to see the result. This will direct you to "answer.asp" which simply checks for one of the 5 responses from the query string and displays a message relating to the response.
![]() |
ChecksByNet Response Merchant Information |
Last Modified: 03/10/05
How ChecksByNet Response Works
ChecksByNet Response will allow you to integrate ChecksByNet into your web site without
having to "link over" to ChecksByNet. You will have full responsibility of
creating the necessary page(s) along with the required information we provide to you. You
will gather all of the check information (available only for United States of America checking accounts with U.S.
funds) from the customer on your web site, then post it
to ChecksByNet from a form. ChecksByNets response code or multiple response codes
will be redirected back to you with the response(s) appended at the end of the query
string. You will need to write a custom application to act on a response issued from
ChecksByNet. Depending on the response(s) received, you will need to create the
corresponding response page(s) and display them to the customer.
Use this location to see how a response code is passed back:
ChecksByNets test check page for a personal check is at http://cross.checksbynet.com/responsecheck.htm.
This form will post all the values to ChecksByNet and send it to a fictitious store named
"Valued CrossCheck Merchant." The store's PaytoID number is placed after the hidden value
"paytoid=". CrossCheck references the merchants store
number from the PayToID
number;
do not use the store number in this field.
All response codes will be sent back to your server recognized by your "paytoid"
number.
Note: It is required that all of the check information is posted to ChecksByNet from a form. If a CGI program cannot post the information to ChecksByNet, you will need to generate a form from that program. This way they can verify the results, and submit these results from this form to ChecksByNet.
To perform a test transaction, complete the form with the required information. Depending on the test being performed, enter the following values for the routing number, account number, and drivers license number:Testing:
Use check number: 123
For Driver's License State enter: ZZ
For Driver's License Number enter: 12345
For Personal MICR enter: S123456780S123456789S123
For Business MICR enter: S123SS123456780S123456789S
Check Amount:
Please use $2.00 for test check transaction amount as much as necessary when testing.
To test with your "paytoid" number for a test response:
Use check number: 123Description |
Field Name |
Constraints |
|
Check Number Value: |
checknbr |
Needs to be greater than 99 / 6 Max | |
Check Dollar Amount Value: |
checkamt |
Needs to be greater than $1.00 / 10 Max | |
Customer's First Name: |
writerfirst |
15 Max | (only for personal checks) |
| Customer's Last Name: | writerlast |
29 Max | |
| Customer's Business Name: | writername |
50 Max | (only for business checks) |
Customer's Address: |
writeraddr |
Street address required / 50 Max | |
City: |
writercity |
30 Max | |
State: |
writerst |
2 characters required | |
Zip: |
writerzip |
5 digits required | |
Bank Name: |
bankname |
50 Max | |
Bank City: |
bankcity |
30 Max | |
Bank State: |
bankst |
2 characters required | |
Bank Zip: |
bankzip |
5 digits required or can be blank | |
MICR: |
micr |
80 Max | |
Customer's Driver's License: |
idnbr |
Do not include dashes or spaces / 40 Max | |
Driver's License State: |
idst |
2 characters required | |
Customer's Phone Number: |
phone |
10 digits required / 14 max | |
Customer's Email: |
"@" and "." required / 50 Max | ||
MICR number must be entered from the bottom of the customer's check starting from left to right. We suggest they enter "S" for each symbol they encounter; however any nonnumeric character can be entered. Please refer to test check pages for examples.
You
can also accept business checks for your company.
ChecksByNets test check page for a business check is at http://cross.checksbynet.com/responsebusiness.htm.
If accepting both business and personal checks, please give the customer the option
to either write a business check or a personal check before they enter any check
information. Two separate forms will need to be created; one for a business check, and one
for a personal check. Please copy the wording from our business test check page. Notice
that a business check contains a "writername" field, and not a
"writerfirst" or a "writerlast" field.
Note: A test response cannot be
issued on a business check for your "paytoid" number. Please notify ChecksByNet
Support if you would like to test for a business check transaction using your
"paytoid" number.
It is
important that each text field has the required field name for ChecksByNet to recognize
them.
back to top
An approved check will send back "RSP0000,######," where "######"
is the 6-digit approval number for the check. If the check is declined, response.asp
will issue the following response: RSP0001. If a field is blank or has invalid
information, additional response codes will be issued all on one line, (see
Table A below). At this point, an application on the merchants server
will create a responding page for the customer depending on the returned response
codes.
TABLE A:
Transaction conclusion responses
|
Description |
Response |
|
Approved |
RSP0000,######, |
| If your account is setup as "Verification Only" with CrossCheck: | |
| Recommended | RSP0002, |
| Not Recommended | RSP0003, |
|
Declined |
RSP0001, |
|
Duplicate |
RSP0020,######, (Check has been approved in the past) |
|
Invalid Merchant |
RSP0051, |
|
Test Complete |
RSP0010, |
Error Response
| Server Unavailable | RSP9999, |
If a "Test Complete" response is passed back (RSP0010,), this page will display with the following query string:
https://cross.checksbynet.com/response.asp?paytoid=###########&response=RSP0010,
RSP0010,
Your application will need to take the response from this page and act on it accordingly.
One or multiple responses can be received. If a customer leaves any of the
fields blank, or enters an invalid ID, Account Number, Routing Number, etc.,
response(s) will be issued for each invalid or blank field.
| Description | Field Name | Response | |
| Check Number Value: | checknbr | RSP1101, | |
| Check Dollar Amount Value: | checkamt | RSP1102, | |
| Customers First Name: | writerfirst | RSP1201, | (only for personal checks) |
| Customers Last Name: | writerlast | RSP1201, | |
| Customers Business Name: | writername | RSP1201, | (only for business checks) |
| Customer's Address: | writeraddr | RSP1202, | |
| City: | writercity | RSP1203, | |
| State: | writerst | RSP1204, | |
| Zip: | writerzip | RSP1205, | |
| Bank Name: | bankname | RSP1301, | |
| Bank City: | bankcity | RSP1302, | |
| Bank State: | bankst | RSP1303, | |
| Bank Zip: | bankzip | RSP1304, | |
| Bank Route | <n/a> | RSP1311, | |
| Bank Account | <n/a> | RSP1312, | |
| MICR Number: | micr | RSP1313, | |
| Customer's Driver's License: | idnbr | RSP1401, | |
| Driver's License State: | idst | RSP1402, | |
| Customer's Phone Number: | phone | RSP1501, | |
| Customer's Email: | RSP1502, | ||
Note: Do not ask for a bank account or a bank route. The bank routing number and account number are checked based on the MICR number that is sent. If an invalid bank route and/or bank account is given from the MICR field, then you will receive a "RSP1311," if it's an invalid bank route, and a "RSP1312," if it's an invalid bank account.
The form must be in the form handling method "POST" and sent to:
<form
method="POST"
action="
<input
type="hidden"
name="paytoid"
value="###########">
or
<form
method="POST"
https://cross.checksbynet.com/response.asp?paytoid=###########"
| Description | URL Field Name | |
| PaytoID Number: | PaytoID | (required) |
| Path to Merchants Application: | ScriptURL | (optional) |
| Memo: | Memo | (optional) |
To direct where the results are to be sent to, you can add an additional field, "ScriptURL." When including the additional field "ScriptURL," it should contain the path to your script or program. ChecksByNet will re-post the information to the URL specified after "ScriptURL," in which the customer will be delivered to the specified URL along with our response(s) appended at the end.
Example:
<form method="POST"
action="https://cross.checksbynet.com/response.asp">
<input type="hidden" name="paytoid" value="###########">
<input type="hidden" name="ScriptURL" value="https://www.domain.com/merchantapp.pl?OrderID=123">
or
<form method="POST"
action="https://cross.checksbynet.com/response.asp?paytoid=###########&ScriptURL=http://www.domain.com/merchantapp.pl?OrderID#1234567">
Example result:
https://www.domain.com/merchantapp.pl?OrderID=123&response=RSP0000,123456,
The memo field will print a record number on the check. You can add additional information in this field if preferred (30 characters max.)
Example:
<form method="POST" action="https://cross.checksbynet.com/response.asp"><input type="hidden" name="paytoid" value="###########">
input type="hidden" name="memo" value="Text up to 30 chars. Max" >
or
<form method="POST"action="
https://cross.checksbynet.com/response.asp?paytoid=###########&memo=Text up to 30 chars. Max "> Rules on ChecksByNet Response IntegrationAgreement Information
Copy and paste this agreement:
| I authorize ChecksByNet to duplicate the preceding information into a bank draft form. I understand that I will receive by email, a check authorization notice, notifying me that a bank draft has been issued on my behalf for said purchase. I will retain my original check for my record of the transaction. |
| I understand that the Payee or authorized agent of Payee, will sign the bank draft as my agent for this transaction only. This authorization is valid for this transaction only. No other bank drafts will be created without my direct written or verbal authorization. All returned checks are subject to a fee of $22.50 or the maximum allowed by law plus returned bank debit fee. |
This must appear before the "I Agree" button. Also provide a picture of a check describing a general concept of where the check routing number, check account number, and the check number occur to assist the customer in filling out the required check information.
back to top Decline InformationIf RSP0001 (Decline) is displayed, the message that the merchant needs to display
should be similar to this:
(Note: If you have your account setup to print declined checks, you may want to
modify this display.)
| We are sorry that we cannot accept your check at this time. | |
| Please return to Merchant's Payto Name and choose
another form of payment. Our decision is based in part on information provided to us by CrossCheck, Inc. In order to protect your privacy you must write to CrossCheck in order for them to release any information which may exist in their files. |
|
Please include the following information so CrossCheck may respond
promptly to your inquiry:
|
|
| We encourage you to write to CrossCheck's Consumer Inquiry Department at P.O. Box 6008, Petaluma, CA 94955-6008. | |
| For additional information please call CrossCheck at (800) 843-0760. | |
Please use this information when notifying the customer their check has been declined. We encourage the customer to write to CrossCheck to find out why their check has been declined. They should also be instructed to choose a different payment method at this time.
If you have any questions or need assistance, please call ChecksByNet Support at 1-800-552-1900.
back to top