Hosted page payment gateways

The hosted page payment gateway solution uses an external site to process the customer's payment information. Because you are using an external site, no sensitive credit card information is stored, transmitted, or processed by Infor Public Sector.

The hosted page gateway was created for use in Infor Rhythm for Civics. See the Infor Rhythm for Civics Administration Guide for more information.

When you select Hosted Page from the Payment Server Gateway list while adding a merchant account, two additional tabs are displayed: Redirect and Payments.

Redirect tab

Use the Redirect tab to redirect the user to the hosted page that will take the payment information. You can use the Contents field on this tab to specify the redirect in one of these ways:

  • You can specify the URL of the site to which the user will be redirected.
  • You can enter HTML as required by the payment processor. For example, integration with Forte Checkout requires you to add an HTML button.
  • You can enter a script.

The Contents field can include template variables, which are placeholders for values from your database. The properties of the MerchantAccount, DrawerTransaction, and PaymentServerTransaction objects are listed in a tree to the right of the Contents field. You can double-click a property in the tree to add it as a template variable.

Alternatively, you can specify a formula in the Contents Configuration Formula field.

Use the Response Mapping grid to define the response mappings for the hosted page gateway. A response mapping takes either a hard-coded value or a property from the response to the web request and maps it to a destination. The mapped value is stored as a custom property on the payment server transaction. The specified destination will be the name of the custom property.

To use a hard-coded value for a response mapping, enter it in the Value column. To use a property from the response, enter it in the Source column. Again, you also have the option to specify a response mapping formula in the Mapping Configuration Formula field.

After they're mapped, you can use the custom properties of the payment server transaction in template variables. This example shows how to retrieve a custom property called "url":

{{oPaymentServerTransaction.CustomProperties.Get("url")}}

Payments tab

Use the Payments tab to define web requests for the various types of cashiering transactions. The Payments tab has these subtabs, each of which defines a web request for a different stage of the payment process:

  • Prepare Payment
  • PreAuthorize Payment
  • Void Payment
  • Authorize Payment
  • Inquire Payment
  • Reverse Payment
  • Inquire Reversed Payment

Each subtab has the same layout.

  • The Configuration Formula field overrides all of the other setups on the subtab. If your configuration is too complex you can use a formula instead.
  • The Contents Configuration Formula field overrides the Contents field.
  • The Format list specifies Json or Xml.
  • The Host Address field specifies the endpoint to use for web requests. This is the URL of the service that you're connecting to. The host address can include template variables.
  • The Request Method list specifies the method of the web request, such as Get or Post.
  • The Mapping Configuration Formula field overrides the Response Mapping grid.
  • The Condition Configuration Formula field overrides the Success Conditions grid.
  • The Time Out field specifies the number of seconds before the web request times out.
  • The Headers grid defines headers for the web request.
  • The Contents field defines the contents of the web request for this transaction type. For example, this might be a SOAP message or a chunk of XML. As with the Contents field on the Redirect tab, you can include template variables in the request contents.
  • The Response Mapping grid defines the response mappings for the web requests. These work the same as the response mappings on the Redirect tab. Use XPath or JSONPath syntax for the Source column, depending on the response format.
  • The Success Conditions grid defines conditions that evaluate the response and determine whether the request is a success. The value in the Name column refers to a destination in the Response Mapping grid.