Skip to main content
Who should use this guideThis guide is intended for merchants who:
  • Use Payrails as a payment orchestrator
  • Use payabl. to accept card, Apple Pay, and Google Pay payments
payabl. is a server-to-server connector with no hosted payment page and no redirect flow for cards. Your shopper enters card details directly in your checkout through the Payrails SDK’s secure fields, or pays with Apple Pay or Google Pay, and payment details go directly to payabl.’s API.

​
Create and configure a payabl. integration in Payrails

Follow these steps to set up payabl.:
  1. Log in to the Payrails portal.
  2. Go to Settings → Integrations → Payments.
  3. Select Add instance to create a new payabl. integration configuration.
  4. Select the workspaces where this integration should be available.
About workspacesWorkspaces determine where this integration is available. They let you isolate provider setups by region or business line, or share the same configuration across multiple workspaces.

​
Step 2: Choose the provider

Select payabl. and continue to the next step. Payrails provider selection set to payabl.

​
Step 3: Configure your payabl. integration

What you’ll need from payabl.Before you begin, make sure you have access to your payabl. dashboard and the following:
  • Merchant ID—your payabl. merchant/account identifier, used to authenticate every request
  • Shared Secret—used to sign every request and to verify that notifications genuinely come from payabl.

​
Integration instance name

An integration instance is a specific payment provider setup in Payrails. You can create multiple instances for each provider based on region, currency, or business needs. Choose a clear, consistent name, since it’s used in routing.
In Payrails
  • Enter an Instance name for your integration.
Payrails integration instance name field for payabl.

​
Account details—Merchant ID & Shared Secret

In payabl.
  • Log in to your payabl. dashboard and locate your Merchant ID & Shared Secret.
In Payrails
  • Enter the Merchant ID & Shared Secret fields with the value from your payabl. account.
Payrails Merchant ID and Shared Secret fields for payabl. Store your Shared Secret securely. Payrails uses it to sign every request sent to payabl. and to verify that notifications genuinely come from payabl.

​
Payment methods

In Payrails
  • Under Payment methods, enable Card, Apple Pay, and/or Google Pay as needed. Each has its own configuration block.
Apple Pay requires additional setupEnabling Apple Pay on the payabl. provider config alone is not enough—you also need a valid Apple Pay configuration (certificate or merchant identity) set up on the Payrails side under Apple Pay settings for your workspace.

​
Meta fields

payabl. requires the following fields on every request. Make sure your checkout collects them and maps them into the corresponding Payrails fields.

​
Enable the integration

In Payrails
  • Select Save account to save the configuration and enable the integration.
  • The Enabled status confirms that the payabl. integration is active.
Your payabl. integration is now ready to process payments.

​
Next steps

  1. Run a test payment in test mode using payabl.’s sandbox testing credentials:
  2. Verify that:
    • The payment appears in your payabl. dashboard.
    • The payment status updates correctly in Payrails.
  3. Once verified in test mode, repeat the setup in live mode.
Continue to: Test a payment
Last modified on September 28, 2026