Tilopay
Connect Tilopay to PayLexer to accept card payments and recurring subscriptions in Costa Rica, Guatemala and Panama through Tilopay's hosted checkout.
Tilopay is a Central American payment gateway based in Costa Rica. PayLexer sends shoppers to Tilopay's hosted payment page, where they pay by card, and Tilopay bills subscription renewals itself through its recurring plans (Tilopay Repeat).
- Supported Regions (Merchant Accounts): Costa Rica, Guatemala and Panama
- Supported Currencies: USD, CRC (Costa Rican colón) and GTQ (Guatemalan quetzal)
The currencies a shopper can pay in also depend on your Tilopay account. If you are unsure which currencies are enabled for you, check with Tilopay before going live.
Supported Features
- Hosted checkout that redirects shoppers to Tilopay's secure payment page
- Card payments
- Recurring subscriptions billed by Tilopay
- Sign-up fees on subscriptions
- Free trials on subscriptions
- Full and partial refunds
Before You Start
Make sure you have:
- Tilopay Account – Don't have one? Sign up for Tilopay →
- 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 Tilopay
You need an API User, API Password and Integration Key from Tilopay for this integration.
Getting API Credentials
Log in to the Tilopay admin panel
Sign in to your Tilopay admin panel.

Open Platform Integrations
Go to Admin panel → Platform Integrations.

Copy your credentials
Copy your API User, API Password and Integration Key.
Keep your API Password and Integration Key private. Together with the API User they give full access to your Tilopay account's payments and refunds.
Adding Credentials to PayLexer
Open PayLexer Dashboard
Log in to your PayLexer dashboard and go to Payment Gateways, find Tilopay and click Configure.

Enter your credentials
Paste the API User, API Password and Integration Key you copied from Tilopay 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
Tilopay uses the same address for test and live payments. Whether a payment is a test or a real one depends on the mode of the Tilopay account whose credentials you enter, so put the credentials of your test account on the Sandbox tab and those of your live account on the Live tab.
Verify and save
Click Verify Connection to check your credentials with Tilopay, then click Save Changes.

Webhooks (Automatic - No Setup Required)
Tilopay doesn't use a webhook secret or signing key that you need to configure. PayLexer sends Tilopay the addresses to notify with every payment and every subscription plan it creates, and confirms each notification directly with Tilopay's own records before acting on it.
- No webhook URL to add in Tilopay's admin panel
- No signing secret to manage
- No need to register URLs in Tilopay: if Tilopay asks you to register your website's URL, you can skip it
- Subscription sign-ups, renewals, failed renewals and cancellations still reach PayLexer automatically
Integrate Tilopay to Your Website
If you have already added and configured your site, you can enable Tilopay 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 Tilopay
Open the Payment gateways tab, tick the checkbox for Tilopay, 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: with Debug/Test mode ON, place test orders using Tilopay's test cards
- Use real email addresses for test orders, since Tilopay rejects payments from some test domains such as
example.com - Confirm with Tilopay which currencies are enabled on your account before going live
- Keep your API Password and Integration Key private, and update them in PayLexer if you change them in Tilopay
- Reconcile your PayLexer orders against the Transactions page in Tilopay periodically
FAQs
Still Have Questions?
- Tilopay Support: Tilopay Support
- PayLexer Support: Contact Support