Deprecated API Integrations Notice:

The Advance Integration Method (AIM) and Hosted Payment Form (Server Integration Method (SIM) or Direct Post Method (DPM)) are deprecated API Integrations. For more information on our current APIs, please visit our Developer Center and Upgrade Guide.

Resolving Timeout Issue and Setting Up Response/Receipt Options in Simple Checkout

When using Simple Checkout, you may encounter a timeout error stating, "An error occurred while trying to report this transaction to the merchant. An email has been sent to the merchant informing them of the error. The following is a result of the attempt to charge your credit card."

This issue is related to the Relay Response feature, which is applicable to merchants using Server Integration Method (SIM), the Direct Post Method (DPM), and Simple Checkout. Relay Response instructs the payment gateway to return transaction results to the merchant using an HTTP POST request to a specified URL on the merchant's Web server. A script or program at the URL can be used to create a custom receipt page using the transaction information. The custom receipt page is then relayed back to the customer's browser. Relay Response does not redirect the end user back to your server, but relays your specified Relay URL to the end user through our receipt page instead of displaying our default receipt page. If a Default Relay Response URL is defined, Simple Checkout will attempt to use it. If this URL does not point at a readily available Web page, the above error may result.

Options for Directing Customers After Transaction Submission

There are several options available for directing customers after they submit a transaction through Simple Checkout:

1. If you want to use Relay Response, ensure that the Default Relay Response URL points at an existing Web page or script that can be loaded within ten seconds or less. Parameterized URLs are not permitted.
2. If you prefer to use our default receipt page, where you can provide a link for customers to click to return to your website, remove the Default Relay Response URL and set a Default Receipt URL for the Web page or script where your customers should return. Parameterized URLs are not permitted.
3. If you would rather not provide either option, you should delete both the Default Receipt URL and the Default Relay Response URL.

How to Add, Edit or Remove the Default Receipt URL or the Default Relay Response URL

1. Log into the Merchant Interface.
2. Select Account from the main toolbar.
3. Select Response/Receipt URLs under Transaction Format Settings.
4. Click Add URL, or click Edit or Delete (if available) to the right of the Default Receipt URL or Default Relay Response URL.
5. Enter the complete URL of the page or script you would like to use. If you wish to remove the URL, select it and delete it from the URL field. Parameterized URLs are not permitted.
6. If you are setting a Default Receipt URL, specify the method that should be used to render the page at that URL. The options available are Link, GET, or POST. If you are not sure which you should use, please consult with your Web developer.
   • Note: If you are setting a Default Receipt URL, you can enter the text that will be displayed for the link, such as "Return To Website."
7. Click Submit.

For more details on Response/Receipt options for Simple Checkout, please see Section Four - Receipt Options in the Server Integration Method (SIM) Developer Guide.