Understanding Integration

Use an API-driven workflow to onboard new merchants. This automated process streamlines the workflow from application submission to equipment activation, helping merchants get started quickly.

The following image and step-by-step guide outline the integration flow:

1

Merchant Data Collection

Merchant onboarding begins with Merchant Data Collection, where the integrator collects and submits essential details using the Integrator UI. This interface integrates with Xpor Pay's backend systems to create and manage merchant profiles.

APIs Used:

Once the data is submitted, Xplor Pay's system validates the provided details and returns responses for verification.

2

Data Validation and Correction

After submitting the application, Xplor Pay validates the data. The Application Fixes Webhook notifies the integration system of any required corrections.

Key Validations Include:

  • Business Contact Validation: Verifies business ownership details and information.

  • Bank Validation: Confirms banking details to prevent transaction errors.

These validations ensure that all merchant information is accurate and ready for processing.

To enable corrections based on webhook notifications, we recommend following these steps:

  1. Implement webhook consumption to receive notifications

  2. Display the notifications to merchants in a user-friendly format

  3. Collect the updated data from merchants

  4. Submit the corrected data using the same APIs used during the Merchant Data Collection process

  5. Proceed with the Sign Application and Submit Application steps

APIs Used:

  • Demographics API: Updates and validates merchant details, taxpayer data, business contacts, and bank account information.

3

Merchant Agreement and Application Submission

Merchants review their applications, sign agreements electronically, and submit the finalized application. Xplor Pay logs terms, IP addresses, and timestamps to ensure transparency.

  • Electronic Signature Submission: Merchants sign agreements electronically to streamline the process.

    Document Upload Alternative: Pre-signed agreements can also be uploaded for verification.

APIs Used:

4

Automated Underwriting and Decisioning

Once the application is submitted, Xplor Pay triggers a Webhook URL again to start the underwriting process. The Automated Underwriting system evaluates the merchant’s risk and compliance. There are three possible outcomes:

  • Approval: The merchant passes underwriting and moves to the equipment setup phase.

  • Manual Review: Additional verification may be required, such as further documentation or business validation.

  • Decline: The application is rejected if the merchant does not meet compliance or risk thresholds.

The merchant receives real-time updates on their application status via Webhook Notifications.

5

Equipment Setup and API Key Integration

For approved merchants, Xplor Pay configures the necessary payment hardware and provides API keys for seamless system integration.

Automated Equipment Setup (Quest/TSYS):

  • Configures merchant hardware, such as POS systems and card readers.

  • Assigns API Keys for merchants integrating with the payment processing system.

Step 5.1: Run Card-Not-Present (CNP) Transactions

From this stage, merchants can begin processing Card-Not-Present (CNP) transactions, such as online, phone, or virtual payments, after their profile is created and data is validated.

6

Equipment Shipping and Activation

After approval, equipment is shipped and pre-configured for immediate use. Merchants can activate the equipment and begin in-person transactions.

Stage 6.1: Run Card-Present (CP) Transactions

After receiving and activating equipment, merchants can process Card-Present (CP) transactions in-store using devices like card readers or POS terminals.

Last updated

Was this helpful?