Ordway Express Checkout provides a unified checkout experience for processing payments, adding payment methods, and completing plan or subscription payments.
Administrators can configure Express Checkout from a single configuration page and select the transaction handling mode and checkout layout. The checkout preview dynamically updates based on the selected configuration, allowing administrators to review the customer experience before publishing it.
Express Checkout supports three transaction handling modes:
- Plan Mode: Provides the standard checkout experience for plan and subscription payments.
- Payment Method Addition: Allows customers to save a payment method without processing a payment.
- Payment Addition: Allows customers to add a payment method and process a payment during checkout.
You can also choose how checkout steps appear to customers by selecting a Single Page or Multi-Page layout.
Contents
- Overview
- Prerequisites
- Access Express Checkout Settings
- Configure Transaction Handling
- Configure Checkout Layout
- Configure Payment Settings
- Review the Checkout Preview
- Customer Information and Input Parameters
- Configure Billing and Payment Method Details
- Complete the Checkout Process
- Frequently Asked Questions
Overview
Previously, Express Checkout configurations supported plan payments separately from Payment and Payment Method modes.
The unified configuration brings these checkout experiences together under one configuration page. Administrators can select the required transaction handling mode and preview the corresponding customer experience.
The unified configuration supports the following capabilities:
- Configure Plan, Payment Method Addition, and Payment Addition modes from one page.
- Select Single Page or Multi-Page checkout layouts.
- Preview the checkout experience based on the selected mode and layout.
- Pass customer information and currency from the application initiating checkout.
- Retrieve existing customer information when a Customer ID is provided.
- Create a new Customer during checkout when no matching Customer exists and a customer name is supplied.
- Configure payment gateway and supported payment methods.
Note: Existing Express Checkout configurations are backfilled to maintain compatibility with previously configured checkout experiences.
Prerequisites
Before configuring Express Checkout, ensure that:
- You have access to Portal Setup in Ordway.
- You have access to Express Checkout in Ordway.
- The required payment gateway is configured for your instance.
- You have selected the transaction handling mode required for your checkout use case.
- The application initiating checkout can supply the required customer and transaction information.
If you intend to accept ACH payments, ensure that ACH payments are enabled in the Payment settings.
Note: Contact the Ordway Support team to enable the portal for your instance.
Access Express Checkout Settings
Complete the following steps to access the unified Express Checkout configuration.
- In Ordway, navigate to Settings > Portal Setup.
- Select the Express Checkout tab.
- Locate the Express Checkout Setup section.
- Under Configuration Setup, select the configuration you want to customize from the dropdown list.
- Review the available configuration sections, including:
- Appearance
- Layout
- Payment
- Legal
- Taxes & Coupons
- The available settings and customer checkout experience depend on the selected configuration and transaction handling mode.
Configure Transaction Handling
The Transaction Handling setting allows you to select the type of checkout experience provided to customers.
To configure the transaction handling mode:
- In Portal Setup > Express Checkout, expand the Payment section.
- Locate Transaction Handling.
- Select one of the following modes:
- Plan Mode
- Payment Method Addition
- Payment Addition
- Review the checkout preview to verify the selected mode.
- Save the configuration after completing the required settings.
Plan Mode
Plan Mode provides the standard checkout experience for plan and subscription payments.
Use this mode when customers need to select a plan, review the associated charges, provide billing information, and complete payment.
The checkout experience supports the following sections:
- Customer Details
- Plan Details
- Plan Selection
- Billing Contact
- Payment Method
During checkout, customers can review the selected plan and applicable charges, provide the required billing information, select a payment method, and confirm the transaction.
Payment Method Addition
Payment Method Addition allows customers to save a payment method without processing a payment.
Use this mode when you want customers to add a payment method for future transactions without charging them during the checkout process.
Depending on the selected payment gateway and enabled payment methods, customers can provide the required card or bank account details.
The checkout collects the payment method information and saves it to the associated Customer.
Note: Payment Method Addition saves the payment method only. It does not process a payment.
Payment Addition
Payment Addition allows customers to add a payment method and process a payment during the checkout process.
Use this mode when a customer needs to provide payment information and complete a payment as part of the same checkout experience.
The customer can:
- Review the payment details.
- Add or select an available payment method.
- Provide the required card or bank account information.
- Review the payment amount.
- Confirm and complete the payment.
The payment is processed using the selected payment method and configured payment gateway.
Configure Checkout Layout
The Layout section controls how checkout steps are presented to customers.
The unified Express Checkout configuration supports two layouts:
To select a layout:
- In Portal Setup > Express Checkout, expand the Layout section.
- Locate Choose how checkout steps are displayed to the customer.
- Select Single Page or Multi-Page.
- Review the checkout preview.
- Save the configuration.
The selected layout applies to both the Self-Service Portal (SSP) and the checkout preview.
Single Page
Select Single Page to display all checkout steps on one page.
Customers can review and complete the applicable checkout information without navigating between separate checkout pages.
This layout is suitable when you want customers to view the complete checkout experience on a single page.
Multi-Page
Select Multi-Page to guide customers through checkout one step at a time.
Customers complete each checkout step before moving to the next step.
Depending on the selected transaction handling mode, the checkout can display separate steps such as:
- Billing Contact
- Payment Method
- Confirm Details
In Plan Mode, the Multi-Page layout uses the checkout's NEXT button to move through the steps. The redundant Confirm Details button is hidden in this flow.
Configure Payment Settings
The Payment section contains the settings used to configure the payment experience.
Depending on your payment gateway and checkout requirements, configure the following options:
| Setting | Description |
| Select your default payment gateway | Select the payment gateway used for checkout transactions. |
| Enable ACH Payments | Enables ACH payments where supported by the configured payment gateway. |
| Transaction Handling | Selects Plan Mode, Payment Method Addition, or Payment Addition. |
To configure these settings:
- Expand the Payment section.
- Select the required payment gateway.
- Enable ACH Payments if customers should be able to use ACH.
- Select the required Transaction Handling mode.
- Review the checkout preview.
Review Checkout Preview
The Express Checkout preview allows you to review the customer experience while configuring the checkout.
The preview dynamically updates based on the selected transaction handling mode and checkout layout.
For example:
- Selecting Plan Mode displays the plan or subscription checkout experience.
- Selecting Payment Method Addition displays the payment method collection experience.
- Selecting Payment Addition displays the payment collection and processing experience.
- Selecting Single Page displays the checkout steps on one page.
- Selecting Multi-Page displays the steps individually.
Review the preview whenever you change the transaction handling mode or layout.
Before saving the configuration, verify that the displayed checkout experience matches your intended customer flow.
Customer Information and Input Parameters
Express Checkout supports customer information supplied by the form or application that initiates checkout.
The customer information is used to identify an existing Customer or create a new Customer when required.
Existing Customer Information
When the initiating application passes a Customer ID, Ordway retrieves the corresponding Customer information.
The checkout experience can use the existing Customer information to prepopulate:
- Customer name
- Billing information
- Address information
This reduces the amount of information customers need to enter during checkout.
Customer name and related fields can be read-only where applicable. Other applicable checkout fields remain editable according to the selected configuration.
Create a New Customer During Checkout
You can also use Express Checkout when the initiating application does not provide a Customer ID.
When no Customer ID is provided, or the supplied Customer ID does not identify an existing Customer, and a customer name is provided, Ordway can create a new Customer during checkout.
The newly created Customer is then associated with the payment or payment method being created.
Example:
- Customer ID: Not provided
- Customer Name: Provided by the initiating application
- Checkout mode: Payment Method Addition
Ordway creates the Customer and associates the saved payment method with that Customer.
Customer Name Input
The customer name can be supplied as an input parameter for:
- Payment Method Addition
- Payment Addition
This allows the checkout experience to display the appropriate Customer information when the transaction is initiated.
Currency Input
Currency is supported as an input parameter from the form or application initiating checkout.
The currency symbol is displayed in the checkout experience, and applicable checkout fields remain editable.
When an explicit currency is not supplied, the company's base currency is used.
Date Default
If the applicable date parameter is not supplied by the initiating application, Ordway uses the current date.
This ensures that the checkout has a date value even when the initiating application does not explicitly pass one.
Configure Billing and Payment Method Details
During checkout, customers can provide payment information using the payment methods supported by the configured payment gateway.
Select or Add a Payment Method
Customers can use an available payment method or enter a new payment method, depending on the selected mode and payment configuration.
The payment method list identifies saved methods using their type and masked account details. For example:
- Card ending with 4444
- Bank account ending with the available masked digits
This helps customers identify the payment method they want to use.
Add a Card or Bank Account
When adding a new payment method, customers enter the required information based on the selected payment method and gateway.
For card payments, the form can include:
- Card number
- Expiration date
- Security code
- Billing address, where required
For bank account payments, the form can include the bank account information and required authorization details.
Configure Billing Address Details
When the checkout requests address information for a payment method, customers can select an available address source or enter an address manually.
The available options include:
Billing Contact
Use the saved billing contact address.
Shipping Contact
Use the saved shipping contact address.
Enter Manually
Enter a new address.
Depending on the selected payment method, the manual address form can include:
| Field | Description |
| Name on Card | Name associated with the payment card, where applicable. |
| Address Line 1 | Primary street address. |
| Address Line 2 | Additional address information, such as a suite or apartment number. |
| Country | Country associated with the address. |
| City | City associated with the address. |
| State | State or region associated with the address. |
| Zip Code/Postal Code | Postal code associated with the address. |
The address section can be expanded or collapsed during checkout.
Complete the Checkout Process
After customers provide the required information, the remaining checkout steps depend on the selected transaction handling mode and layout.
The below image depicts the Checkout process in Express Checkout:
Complete Plan Mode Checkout
- Review the customer and plan information.
- Select the required plan and charges.
- Review the billing contact information.
- Select or add a payment method.
- Review the confirmation details.
- Complete the payment.
Complete Payment Method Addition
- Provide the required customer information.
- Enter or select the payment method.
- Provide any required billing address and authorization details.
- Submit the payment method information.
The payment method is saved without processing a payment.
Complete Payment Addition
- Review the customer information.
- Enter or select the payment method.
- Review the payment amount and transaction details.
- Confirm and submit the payment.
Ordway processes the payment using the selected payment method.
Return to the Configured URL
After a payment or payment method addition completes successfully, Ordway redirects the customer to the configured Return URL after three seconds.
This allows the initiating application to receive the customer after the checkout process is completed.
Frequently Asked Questions
| Questions | Answers |
| What modes does Express Checkout support? | Express Checkout supports three modes: Plan Mode, Payment Method Addition, and Payment Addition. |
| Which checkout layouts are available? | You can choose Single Page to display all checkout steps together or Multi-Page to guide customers through checkout one step at a time. |
| Does Payment Method Addition charge the customer? | No. It saves the payment method without processing a payment. |
| What happens after checkout is completed? | After a payment or payment method addition succeeds, Ordway redirects the customer to the configured Return URL. |
Comments
0 comments
Please sign in to leave a comment.