Going live

Prove the whole flow in PayGlocal's sandbox (UAT), then switch off Test Mode and swap in production keys.

Prerequisites: keys generated for both UAT and production, and an active license.

Stage 1 — Test in the sandbox

Set Test / Sandbox Mode = Yes to route payments to PayGlocal's UAT environment.

Use UAT keys in sandbox

Sandbox and production use different keys. While testing, configure your UAT RSA key and PayGlocal's UAT common certificate, with their matching KIDs. See PayGlocal key setup.

Then run a real test payment:

1. Confirm the sandbox settings

Open Setup → Payment Gateways → PayGlocal and check that Test / Sandbox Mode is set to Yes, your MID is correct, and the UAT key paths and KIDs are filled in. Save Changes.

2. Take a test payment

Create a test invoice, click Pay Now, and pay through the PayGlocal hosted checkout using PayGlocal's UAT test credentials. You should be redirected to the checkout, complete the payment, and return to WHMCS with the invoice marked Paid.

3. Check the Gateway Log

Open Utilities → Logs → Gateway Log and confirm the payment recorded cleanly — the signed callback verified and the status cross-check ran. If anything failed, fix it now (see Troubleshooting) before going live.

Stage 2 — Switch to production

When a sandbox payment completes and verifies cleanly, move to live.

1. Swap in your production keys

Replace UAT keys with your production merchant private key and PayGlocal production certificate (stored outside the web root, chmod 640). Update all four key paths and KIDs in gateway settings. See PayGlocal key setup.

2. Turn off Test Mode

Set Test / Sandbox Mode to No. Confirm your production Merchant ID (MID) is entered and your License Key is active. Save Changes.

3. Make one real payment

Take a small live payment (refund it afterward if you like) to confirm production works end to end, then check the Gateway Log one more time.

Go-live checklist

Before you accept real payments

• [ ] Sandbox test payment completed and verified in the Gateway Log
• [ ] Test / Sandbox Mode = No
• [ ] Production merchant private key + PayGlocal common certificate in place
• [ ] Both .pem files outside the web root, chmod 640
• [ ] All four key paths and KIDs match the production keys
• [ ] Correct production Merchant ID (MID)
• [ ] License Key entered and active (payments are disabled while inactive)
• [ ] Valid SSL certificate on your WHMCS domain
• [ ] One real payment tested successfully
• [ ] If using recurring: PayGlocal Recurring activated, its two SI options set, and the WHMCS daily cron running

Related pages

• PayGlocal key setup — UAT vs production keys
• Configuration — every gateway field explained
• How payments work — the flow you're testing
• How recurring payments work — mandates and the daily cron
• Licensing — why an active license is required
• Troubleshooting — when a test payment fails