How to Integrate VersaPay Payment with ToolSwift for B2B eCommerce

Versapay is a payment and accounts receivable solution designed for B2B ecommerce businesses that operate with credit terms, invoices, and customer-managed payments. When integrated with ToolSwift, Versapay allows merchants to offer flexible payment options while maintaining control over invoicing and receivables. This guide explains how to connect Versapay to your ToolSwift account and what to expect once the integration is enabled.

Step 1: Log in to Versapay and Access Settings

1. Log in to your Versapay account at versapay.transactiongateway.com

2. In the left sidebar, click on OPTIONS to expand the menu

3. Click on Settings

Step 2: Navigate to Security Keys

1. On the Gateway Options page, under Security Options, click on Security Keys

Step 3: Copy Your Private Security Key (API Security Key)

1. On the Security Keys page, scroll down to the Private Security Keys section

2. Find your API key in the table (look for one with "API" as the Source)

3. Click the Copy button next to your key to copy the Private Security Key

4. Save this key - you will need it as your API Security Key in the Admin Dashboard

Step 4: Copy Your Public Security Key

1. On the same Security Keys page, scroll down to the Public Security Keys section

2. Find your key in the table (look for one with "Tokenization" as the Source)

3. Click the Copy button next to your key to copy the Public Security Key

4. Save this key - you will need it as your Public Key in the Admin Dashboard

Before configuring the Admin Dashboard, you need to set up webhooks in Versapay to receive transaction notifications.

Step 5: Navigate to Webhooks

1. Go back to Gateway Options (click OPTIONS > Settings in the sidebar)

2. Under Transaction Options, click on Webhooks

Step 6: Create a New Webhook

1. On the Webhooks page, you will see any existing endpoints

2. Click the Create button to add a new webhook endpoint

Step 7: Configure the Webhook URL and Subscribe to Events

1. In the URL field, paste your Webhook Endpoint URL from the Admin Dashboard (see Part 3, Step 9 on how to get this URL)

2. In the Available Events section, click the arrow button next to each event you want to subscribe to. This will move it to the Subscribed Events column

3. Subscribe to all relevant events for your integration (transaction.sale.success, transaction.sale.failure, etc.)

Step 8: Save Your Webhook Configuration

1. After selecting all the events you need, verify they appear in the Subscribed Events column

2. Click Save Changes to save your webhook configuration

Now that you have gathered all your credentials from Versapay, you need to enter them in the Admin Dashboard.

Step 9: Enter Your Credentials in Admin Dashboard

1. Navigate to the Connect Versapay page in the Admin Dashboard

2. Fill in the following fields:

API Security Key: Paste the Private Security Key you copied in Step 3

Webhook Signing Key: Enter your Versapay Webhook Signing Key

Public Key: Paste the Public Security Key you copied in Step 4

3. Important: Copy the Webhook Endpoint URL shown on this page (click the Copy button). You will need this URL to configure webhooks in Versapay (Step 7)

4. Click Connect Versapay to complete the integration