This article will guide merchants through using the Server Integration Method (SIM) Hosted Payment Form.

Important Note

The Advanced Integration Method (AIM), Server Integration Method (SIM), and Direct Post Method (DPM) are now obsolete and in the process of being phased out. We strongly suggest using one of our modern connection methods to integrate with the Authorize.net Payment Gateway. Visit our Developer Center and Upgrade Guide for more information on our updated APIs.

Server Integration Method (SIM)

The Server Integration Method (SIM) provides a secure method for integrating an online payment system into your website. It is designed to handle all steps in the secure transaction process, from transaction submission to the delivery of the transaction response.

Configuring the Hosted Payment Form and Receipt Pages

To add or configure information on the hosted payment form, receipt page, or email receipt, follow these steps:

1. Sign in to the Merchant Interface.
2. Click Payment Form under Transaction Format Settings - Transaction Submission Settings.
3. Select Payment Form.

Payment Form - Colors

Specify the colors to be used to display text, text links, and the background of the payment form:

1. Click the Text Only drop down box and highlight a color to use for the text on the Payment Form. This color will be used to display text on the payment form.
2. Repeat this step for the Text Links drop down box. The color selected in this drop down box will be used to display text links on the payment form.
3. Repeat this step for the Background drop down box. The color selected in this drop down box will be used as the background color for the payment form.
4. Click Submit.

If you are familiar with the use of hexadecimal codes for color, and you do not find an appropriate color match in the drop-down boxes, you can enter the hexadecimal number in the appropriate field. To enter your own hexadecimal color value, select "HEX Color Code" in the drop-down box and enter the appropriate value in the text box to the right of the drop-down. After entering the numbers, click Submit.

Payment Form – Header

Specify the header text that should appear at the top of the payment form:

1. Click in the Header Text box to obtain a flashing text cursor.
2. Type the header that you would like to use on your Payment Form. The text of the header may only be 255 characters or less in length, due to the size restrictions of the form.
3. Click Submit.

Payment Form – Form Fields

Specify the fields that may be viewed and edited by a customer, and required to complete a transaction:

1. Determine which fields must be available on the Payment Form.
2. Click each check box under either the "View." "Edit" or "Required" headers to allow that information field to be shown and/or to be required for a transaction.

The following list summarizes the functions of each check box:

• View – The information in these fields will be displayed on the payment form. These fields will not be edited by a user. The information in fields specified with a check in the View column will only be displayed to users on the payment form.
• Edit – These fields are displayed to allow users to enter or edit information. These fields appear as text boxes in which users may enter information.
• Required – These fields will require a value be entered before a transaction may be submitted.

NOTE: Choosing a field as "Required" automatically makes that field viewable and able to edit. Choosing a field as "View" or "Edit" will allow that field to be shown during the transaction but will NOT make it a required field unless you choose the Required box.

3. Click Submit.

Payment Form - Footer

Specify the text that should appear as the footer of the payment form:

1. Click in the Footer Text box to obtain a flashing text cursor.
2. Type the footer that you would like to use on your Payment Form. The text of the footer may only be 255 characters or less in length, due to the size restrictions of the form.
3. Click Submit.

Receipt Form – Receipt Method

The receipt form may be used to display information to the customer upon successful processing of a transaction. You may include a link to your website on this page, and display information with custom headers and footers.

Choose the method in which the application should display the transaction receipt:

1. Select either Link, Get, or Post. These options are displayed as radio buttons indicating that only one method may be selected.
   • LINK creates a regular hyperlink.
   • GET creates a button and returns transaction information in the receipt link URL.
   • POST creates a button and returns transaction information as HTML Form POST data.
2. To display an active link on the receipt form, indicate the text of this link that will be displayed to the customer. Place the cursor in the Link Text box and enter the text that should be displayed as a clickable hyperlink to the customer on the receipt page.
3. Provide the URL to which a user should be redirected once the link is clicked from the receipt page. Place your cursor in the Receipt Link URL text box. Enter the URL to which customers will be redirected once the link is clicked from the receipt page. Parameterized URLs are not permitted.
4. Click Submit.

Receipt Form - Header

Specify the header text that will appear at the top of the receipt form:

1. Click in the Header Text box to obtain a flashing text cursor.
2. Type the header that to use on your Receipt Form. The text of the header may only be 255 characters or less in length, due to the size restrictions of the form.
3. Click Submit.

Receipt Form - Footer

Specify the text that should appear as the footer of your receipt form:

1. Click in the Footer Text box to obtain a flashing text cursor.
2. Type the footer that you would like to use on your Receipt Form. The text of the footer may only be 255 characters or less in length, due to the size restrictions of the form.
3. Click Submit.

Enable/Disable Security Code (Captcha)

To enable or disable the Security Code option on the Authorize.net hosted payment form, follow these steps:

1. Sign in to the Merchant Interface.
2. Click Payment Form under Transaction Format Settings - Transaction Submission Settings.
3. Select Payment Form.
4. Select Form Fields.
5. Select or Deselect the box labeled "Require the Security Code feature on the Payment Form".
6. Select Submit to save the settings.

Note: When using Simple Checkout, the customer is always required to verify a Security Code. Even if the Security Code is disabled from the payment form, the customer is required to verify a Security Code on the Simple Checkout order page.

Hosted Form FAQs

• Can I set a default payment type on the hosted form?
  • You can set the default method of Credit Card or eCheck (ACH) via the API call used by SIM using the x_method field.