Hosted Controls Demo Builder

Adjust the different settings and build a custom demo to match your application's needs. Prebuilt examples can be found in the Auto Populate section. Hover over each example for additional details.

Setup

Operation Type

Payment Source Type

Card Entry Context (Use with Credit Source Type)

ACH Authorization Type (Use with ACH Source Type)

Additional Options

Card Number Input Placeholder

Expiration Month Input Placeholder

Expiration Year Input Placeholder

CVV Input Placeholder

Account Number Input Placeholder

Routing Number Input Placeholder

Account Type Input Placeholder

Submit Button Text

Include Digital Wallet Integration

Language Preference Information

Hosted Payments determines the appropriate localization based on the Language Preference Rule:

0 - Default/Not Provided. Content is localized to en-US
1 - Fallback to Language Preference Tag if no valid Accept-Language is provided. If the Language Preference Tag is also invalid, use en-US
2 - Force use of the Language Preference Tag. If no valid tag is provided, use en-US for localization.

Language Preference

Language Preference Rule

Hosted Controls - Digital Wallet Setup

Setup

Total Amount The Amount field is required.

Tax Amount

Use Custom Styling

Digital Wallet Types To Exclude

Button Type

Button Style

Button Height

Button Width

Shipping Information

First Name

Last Name

Address Line 1

Address Line 2

Address Line 3

City

State

Zip

Country

Phone

Email

Required Billing Information

Name

Address

Email

Phone

Required Shipping Information

Name

Address

Email

Phone

Shipping Options

Shipping Option Criteria

The maximum number of Shipping Options is five.
The ID of each Shipping Option must be unique.
The amount for each shipping option must be greater than or equal to zero.

ID	Amount	Label	Description

Shipping Address Update Options

Apple and Google allow you to subscribe to updates when the customer changes their shipping address in order to respond with updated tax and shipping costs.

This demo site has a few callbacks that you can select from that are examples of how you can create callbacks with your own logic as you integrate to this service.

Note that these only take affect if the shipping address is required.

None - No change will happen
Higher International Costs - The shipping amount will increase by $10.00, and the tax amount will increase by $5.00
Increase Based on City Name - The shipping amount will increase by the number of characters in the city name, and the tax amount will increase by half of that
Free Shipping to Certain Postal Codes - When the customer's postal code is 12345, PO11EB (United Kingdom), or A1A (Canada), the shipping amount will be reduced to $0.00

The following options are to provide a visual for the error that will be returned if the Shipping Options provided after the Shipping Address is changed do not meet the validation criteria. No values are altered except the Shipping Options.

Error Testing: Returned Shipping Options are Negative
Error Testing: Too Many Shipping Options are Returned
Error Testing: Returned Shipping Options have Matching IDs

Shipping Address Change Options

Custom Merchant Authorization Information (Optional)

To test the demo builder with an alternative merchant, enter the authorization details below. Leaving any field blank will default the transaction to the demo merchant.

User Name

Password

Merchant Name

Auto Populate

Card Examples

ACH Examples

Instructions

This page allows you to configure demo pages to match the use case for your application.

Setup

Select the operation and payment source, then select the appropriate authorization method. Card Entry Context for Credit, or ACH Authorization Type for ACH

Payor Information

Next fill in the Payor information panel. If you want to simulate having payor information already provided by your system, go ahead and enter it here. If you leave it blank it will be expected to be entered on the demo page. Use the check boxes to show whether these fields will show on the Demo Host page.

Note: Only the Name on Account and Zip code are required for Hosted Payments, the other fields are optional.

Additional Options

Card Number Input Placeholder - Add custom placeholder text to the CardNumber input control
Expiration Month Input Placeholder - Add custom placeholder text to the Expiration Month input control
Expiration Year Input Placeholder - Add custom placeholder text to the Expiration Year input control
CVV Input Placeholder - Add custom placeholder text to the CVV input control
Account Number Input Placeholder - Add custom placeholder text to the Account Number (ACH) input control
Routing Number Input Placeholder - Add custom placeholder text to the Routing Number (ACH) input control
Account Type Input Placeholder - Add custom placeholder text to the Account Type (ACH) input control