Payment GatewaysPayFabric

PayFabric

Connect PayFabric to PayLexer to accept hosted card payments and process full or partial refunds through your existing payment processor.

PayFabric is a payment platform from Global Payments, operated by EVO Merchant Services, LLC. It is widely used by North American businesses running Microsoft Dynamics and similar ERP systems, and it provides hosted payment pages, card tokenization and a card vault on top of a merchant's existing processor relationship.

  • Supported Regions (Merchant Accounts): United States and Canada
  • Supported Currencies: USD, CAD, AUD, EUR, GBP and NZD are accepted by PayLexer. PayFabric does not set the settlement currency itself, which depends on your own processor account.

Supported Features

  • Hosted payment page, so shoppers enter card details on PayFabric and never on your site
  • Card tokenization and a card vault held by PayFabric
  • Full and partial refunds
  • Transaction notifications posted to PayLexer as each payment is processed
  • Separate sandbox and live accounts for safe testing

Before You Start

Make sure you have:

  • PayFabric Account – PayFabric does not offer self-service signup. Your account and credentials are issued through merchant onboarding with Global Payments or EVO. Contact PayFabric →
  • A gateway profile – Connected to your processor account inside PayFabric, for example EVO US_CC
  • PayLexer Account – Required to configure the integration. Create your account →
  • A website where you want to integrate

Looking for a different payment processor? View all supported gateways →

A sandbox account is self-service and available immediately. Live credentials and a live gateway profile require merchant onboarding with Global Payments or EVO, which happens outside PayLexer.

Configuring PayFabric

You need a Device ID, Device Password and Gateway Profile (Setup ID) from PayFabric for this integration.

Getting API Credentials

Log in to the PayFabric portal

Open the sandbox portal for testing, or the live portal for production.

PayFabric portal sign-in screen
PayFabric portal sign-in screen

Sandbox and live are separate accounts with separate portals. Credentials from one never work on the other.

Create a device

Go to Settings → Dev Central → Device Management and create a device for PayLexer. Give it a name you will recognize later, then set and confirm its password.

Device Management tab in PayFabric Dev Central with the Generate button
Device Management tab in PayFabric Dev Central with the Generate button
New device dialog with Device Name, Password and Confirm Password fields
New device dialog with Device Name, Password and Confirm Password fields

You choose the Device Password yourself on this screen, and PayFabric will not show it again afterwards. Save it somewhere safe before you click Confirm.

Copy the Device ID

Copy the Device ID exactly as shown, including the number and colon before the long identifier. It looks like 2:00000000-0000-0000-0000-000000000000, and all of it is part of the credential.

Device ID value displayed in the PayFabric portal, showing the number and colon prefix
Device ID value displayed in the PayFabric portal, showing the number and colon prefix

Copy the gateway profile name

Go to Settings → Gateway Account Profiles and copy the Name of the profile you want to charge through, for example EVO US_CC.

Choose the card profile, not an ACH or eCheck profile. The name must match exactly, including spaces and underscores.

Gateway Account Profiles page in PayFabric showing the Name column
Gateway Account Profiles page in PayFabric showing the Name column

Adding Credentials to PayLexer

Open PayLexer Dashboard

Log in to your PayLexer dashboard and navigate to Payment Gateways → PayFabric.

PayLexer dashboard Payment Gateways list with PayFabric highlighted
PayLexer dashboard Payment Gateways list with PayFabric highlighted

Enter your credentials

Paste the Device ID, Device Password and Gateway Profile (Setup ID) you copied from PayFabric into the corresponding fields.

Sandbox credential fields for PayFabric in the PayLexer dashboard
Sandbox credential fields for PayFabric in the PayLexer dashboard
Live credential fields for PayFabric in the PayLexer dashboard
Live credential fields for PayFabric in the PayLexer dashboard

Understanding Live/Production and Sandbox Settings:

EnvironmentPurpose
Live / Production (Mandatory)Used for real transactions. Cannot be empty, even when testing.
Test / Sandbox (Optional)Used for testing only. No real money is processed.

How PayLexer selects credentials:

  • Debug/Test mode ON → Test credentials are used
  • Debug/Test mode OFF → Live credentials are used

Configuring Webhooks

Webhooks deliver each payment result the moment PayFabric processes it. PayLexer also re-checks every unresolved order every 30 minutes, so webhooks make updates immediate rather than being the only way an order can complete.

Benefits of Webhooks:

  • Instant payment status updates
  • Refunds recorded as soon as PayFabric processes them
  • A record of each transaction outcome as PayFabric reports it

Copy your webhook URL from PayLexer

On the PayFabric configuration page in PayLexer, copy the Webhook URL shown in the read-only field.

Read-only Webhook URL field on the PayFabric page in the PayLexer dashboard
Read-only Webhook URL field on the PayFabric page in the PayLexer dashboard

Open Transaction Options in PayFabric

In the PayFabric portal, go to Settings → Dev Central → PayFabric Settings, select the device you created from the Device Name list, then open the Transaction Options tab.

The notification setting belongs to the device, so make sure the correct device is selected before you change anything.

PayFabric Settings page with the Device Name list used to select a device
PayFabric Settings page with the Device Name list used to select a device
Transaction Options tab in the PayFabric Settings section
Transaction Options tab in the PayFabric Settings section

Paste the URL and set the format

Paste the webhook URL into the Post URL field, set the Post URL Content-Type header to Default, and click Save.

Post URL and Post URL Content-Type header fields in PayFabric Transaction Options
Post URL and Post URL Content-Type header fields in PayFabric Transaction Options

Do not choose Legacy. The Legacy setting labels its notifications as one format while actually sending another, so PayLexer cannot read them and every notification is rejected. Default sends the same information correctly labelled.

There is no webhook signing key for PayFabric. PayFabric posts the transaction response to your Post URL unsigned, so PayLexer treats notifications as a speed improvement and re-checks every unresolved order directly every 30 minutes.

Test and Save

Click Save to save your configuration and verify your credentials. Click Verify Connection to test the connection.

Save and Verify Connection buttons on the PayFabric configuration screen in PayLexer
Save and Verify Connection buttons on the PayFabric configuration screen in PayLexer

PayLexer checks the gateway profile as well as the credentials, so a misspelled profile name is caught here rather than surfacing later as a failed payment.

Integrate PayFabric to Your Website

If you have already added and configured your site, you can enable PayFabric in your existing setup.

Go to Websites

Navigate to Websites in your PayLexer dashboard.

Edit your website

Click the Edit Icon of your added website.

Websites list in the PayLexer dashboard with the Edit icon on a website row
Websites list in the PayLexer dashboard with the Edit icon on a website row

Enable PayFabric

Click the checkbox to enable PayFabric for the website.

Payment gateway checkboxes for a PayLexer website with PayFabric selected
Payment gateway checkboxes for a PayLexer website with PayFabric selected

If you haven't added a website yet, Continue to Add Your Website →

Troubleshooting

Best Practices

  • Test in sandbox before enabling production. Use PayFabric's test card 4111 1111 1111 1111 with any future expiry date and any CVC.
  • Store the Device Password somewhere safe as soon as you set it, because PayFabric will not show it again.
  • Set the Post URL on every device you use with PayLexer, not just the first one.
  • Confirm with your processor which currencies your account can actually settle before offering them at checkout.

FAQs

Still Have Questions?

Was this page helpful?