Payroc
Connect Payroc to PayLexer to accept credit and debit cards and ACH bank transfers from shoppers in the United States and Canada on Payroc's secure hosted payment page.
Payroc is a North American payment processor that serves merchants in the United States and Canada. Through its Payroc Essentials hosted payment page, your shoppers pay by credit or debit card (Visa, Mastercard, American Express, Discover) or by ACH bank transfer on Payroc's own secure page, then return to your store.
- Supported Regions (Merchant Accounts): United States and Canada
- Supported Currencies: USD, CAD
Supported Features
- Hosted checkout that redirects shoppers to Payroc's secure payment page
- Credit and debit cards (Visa, Mastercard, American Express, Discover)
- ACH bank transfers
- Full refunds
- Partial refunds
- Same-day refunds are voided by Payroc, so the shopper is never charged
- Real-time card payment notifications, signed by Payroc and verified by PayLexer
- Signed shopper returns, checked by PayLexer before the store shows a result
- Automatic follow-up on payments that are still pending, including ACH
- Separate test and live credentials for safe testing
Payroc does not support subscriptions or recurring billing in PayLexer. Only one-time payments are available. Apple Pay and Google Pay are not available on Payroc's hosted payment page.
Before You Start
Make sure you have:
- Payroc Account - Accounts are opened through Payroc's sales team. Contact Payroc →
- Payroc test (UAT) terminal – Payroc's integration team sets up a test terminal and its API key for you. Ask your Payroc contact if you do not have one
- 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 →
Configuring Payroc
You need a Terminal ID, Terminal Secret and API Key from Payroc for this integration.
Getting API Credentials
Log in to the Payroc Self-Care Portal
Sign in to the Payroc Self-Care Portal. For test credentials, sign in to the Payroc test (UAT) Self-Care Portal instead, which is a separate system with its own login.

Copy your Terminal ID
Go to Settings → Terminal. Your Terminal ID is the number shown for your terminal, for example 6821001 (USD). Copy only the digits (6821001), not the currency in brackets.

Set your Terminal Secret
On the same terminal settings page, enter a long, random value in Secret and Confirm Secret, then save. If Payroc has emailed you a secret, enter that one instead. This is your Terminal Secret.
Keep your Terminal Secret private. It signs every payment PayLexer sends to Payroc, and it is how PayLexer checks that payment results genuinely came from Payroc. Changing it affects everything that uses this terminal, so update PayLexer at the same time.
Get your API Key
Payroc issues the API Key for your terminal, usually by email from your Payroc contact. PayLexer uses it to look up, refund and void payments.
Use the API Key Payroc issued for this terminal. Keys you create yourself under Settings → API Keys in the Self-Care Portal are Payroc App keys and do not work here, and a key from Payroc's Developer Portal cannot see test (UAT) terminals.
Adding Credentials to PayLexer
Open PayLexer Dashboard
Log in to your PayLexer dashboard and go to Payment Gateways, find Payroc and click Configure.

Enter your credentials
Paste the Terminal ID, Terminal Secret (Self-Care Portal) and API Key you got from Payroc into the corresponding fields.

Understanding Live/Production and Sandbox Settings:
| Environment | Purpose |
|---|---|
| Live / Production | Used for real transactions. |
| Test / Sandbox | 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
Test and live are separate terminals at Payroc, each with its own Terminal ID, Terminal Secret and API Key. Enter test (UAT) values on the Sandbox tab and live values on the Live tab.
Verify and save
Click Verify Connection to check your credentials with Payroc, then click Save Changes.

Verify Connection checks that your API Key is valid and can read your Terminal ID. It cannot check the Terminal Secret, which Payroc only checks when a shopper opens the payment page. Place a small test payment to confirm it.
Configuring Webhooks (Mandatory)
Webhooks enable real-time payment updates and significantly improve reliability.
Benefits of Webhooks:
- Instant payment status updates
- Orders complete even if the shopper closes the browser before returning to your store
Payroc does not take these addresses with each payment. You enter two PayLexer addresses once, in your terminal settings in the Self-Care Portal. There is no separate webhook secret: Payroc signs its notifications with your Terminal Secret.
Copy your PayLexer Webhook URL
On the Payroc configuration page in PayLexer, copy the Webhook URL.

Open your terminal settings
In the Payroc Self-Care Portal, go to Settings → Terminal and open your terminal. Use the test (UAT) portal for your Sandbox credentials and the live portal for your Live credentials.
Set the Validation URL
Tick Enable Validation and paste your PayLexer Webhook URL into Validation URL.

Set the Receipt Page URL
In Receipt Page URL, enter the same host as your Webhook URL but with the path /redirect-callback/payroc. For example, if your Webhook URL is https://processor.paylexer.com/webhooks/payroc/abc123, enter https://processor.paylexer.com/redirect-callback/payroc. This is where Payroc sends the shopper after they pay.

Without the Receipt Page URL, shoppers are not brought back to your store after paying. Type it carefully and make sure it has no tenant ID at the end.
Save and place a test payment
Save the terminal settings. With Debug/Test mode ON, place a small test payment and check that the order changes to paid in PayLexer.
Payroc sends these notifications for card payments only. ACH bank transfers are confirmed when the shopper returns to your store, and PayLexer follows up automatically on any payment that is still pending.
Integrate Payroc to Your Website
If you have already added and configured your site, you can enable Payroc in your existing setup.
Go to Websites
Navigate to Websites in your PayLexer dashboard.
Open your website
In your website's row, click the Edit icon (pencil) in the Actions column to open its page.

Enable Payroc
Open the Payment gateways tab, tick the checkbox for Payroc, then click Save gateways.

If you haven't added a website yet, Continue to Add Your Website →
Troubleshooting
Best Practices
- Test in sandbox before enabling production
- Use amounts ending in .00 or .05 for successful test payments
- Refund from your store or PayLexer, not from the Payroc Self-Care Portal
- Keep your Terminal Secret and API Key private and change them if you think they have been exposed
- Check Validation Result in the Self-Care Portal after your first live payment to confirm notifications are reaching PayLexer
FAQs
Still Have Questions?
- Payroc Support: Contact Support
- Developer Docs: Payroc Developer Docs
- PayLexer Support: Contact Support