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

Integration Note

The Advanced Integration Method (AIM), Server Integration Method (SIM), and Direct Post Method (DPM) are obsolete and in the process of being phased out. We 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. Be on or switched into the New Merchant Interface (2.0)
3. Click Payment on the left navigation
4. Click Payment Settings

Payment Form and Receipt Page Colors and Fonts Customization

Setting Default Values:

1. Click the label or arrow next to Payment Form.
2. Click the label or arrow next to Color and Font Settings.
3. Set and change the values for font, size color for the text, link and back ground under Default Colors and Fonts.
   1. For colors use the drop down to select preset colors or Hex option to define by a hex color value.
4. Click Preview at the bottom right to test.
5. Click Save to complete the update.
6. These settings will be used for any defaults.

Setting Payment Form Heading:

1. Click the label or arrow next to Payment Form.
2. Click the label or arrow next to Color and Font Settings.
3. Navigate to the Payment Form Heading
4. To use the default settings set the Font, Size and Color to default.
5. Otherwise you can set custom values separate from your defaults.
6. Use the preview option to check and test any changes before clicking Save to update your settings.

Setting Receipt Page Heading:

1. Click the label or arrow next to Payment Form.
2. Click the label or arrow next to Color and Font Settings.
3. Navigate to the Receipt Page Heading
4. To use the default settings set the Font, Size and Color to default.
5. Otherwise you can set custom values separate from your defaults.
6. Use the preview option to check and test any changes before clicking Save to update your settings.

Payment Form - Header Text

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

1. Click the label or arrow next to Payment Form.
2. Click the label or arrow next to Header.
3. Enter the header text in the text box. The text of the header may only be 255 characters or less in length, due to the size restrictions of the form.
4. Use the preview option to check and test any changes before clicking Save to update your settings.

Payment Form - Footer Text

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

1. Click the label or arrow next to Payment Form.
2. Click the label or arrow next to Footer.
3. Enter the footer text in the text box. The text of the footer may only be 255 characters or less in length, due to the size restrictions of the form.
4. Use the preview option to check and test any changes before clicking Save to update your settings.

Payment Form – Form Fields

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

1. Click the label or arrow next to Payment Form.
2. Click the label or arrow next to Form Fields.
3. Click each check box under either the "View." "Edit" or "Required" to allow that information field to be shown and/or to be required for a transaction.
4. Use the preview option to check and test any changes before clicking Save to update your settings.

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.
  • 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.

Payment Form – Security Code (Captcha)

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

1. Click the label or arrow next to Payment Form.
2. Click the label or arrow next to Form Fields.
3. Navigate to Security Code section at the bottom of the page.
4. Check or uncheck the box for "Require the Security Code feature on the Payment Form" to enable or disable it.
5. Use the preview option to check and test any changes before clicking Save to update your settings.

When using Simple Checkout, customers must always verify a Security Code. Even if the code is hidden on the payment form, it will still be required on the order page.

Payment Form – Shipping and Return Policies

To set a shipping and return policy link. follow these steps:

1. Click the label or arrow next to Payment Form.
2. Click the label or arrow next to Form Fields.
3. Navigate to Shipping and Return Policies section at the bottom of the page.
4. Enter/provide your shipping and return policy url/page.
5. Use the preview option to check and test any changes before clicking Save to update your settings.

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. Click the label or arrow next to Receipt Page.
2. Click the label or arrow next to Form Fields.
3. Click the label or arrow next to Receipt Method.
4. Enter/provide the default receipt page url/page, users will be directed to this page based on the method selected below. Parameterized URLs are not permitted.
5. 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.
6. Enter/provide the text for the link to display. The text entered will be displayed as a clickable hyperlink to the customer on the receipt page.
7. Click Submit.

Receipt Form - Header Text

Specify the header text that should appear at the top of the receipt page:

1. Click the label or arrow next to Receipt Page.
2. Click the label or arrow next to Header.
3. Enter the header text in the text box. The text of the header may only be 255 characters or less in length, due to the size restrictions of the form.
4. Use the preview option to check and test any changes before clicking Save to update your settings.

Receipt Form - Footer Text

Specify the footer text that should appear at the top of the receipt page:

1. Click the label or arrow next to Receipt Page.
2. Click the label or arrow next to Footer.
3. Enter the footer text in the text box. The text of the footer may only be 255 characters or less in length, due to the size restrictions of the form.
4. Use the preview option to check and test any changes before clicking Save to update your settings.

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.