Payment GatewaysTilopay

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:

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.

Tilopay admin panel sign-in page
Tilopay admin panel sign-in page

Open Platform Integrations

Go to Admin panel → Platform Integrations.

Platform Integrations page in the Tilopay admin panel showing the API credentials
Platform Integrations page in the Tilopay admin panel showing the API credentials

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.

Tilopay listed under Payment Gateways in the PayLexer dashboard with the Configure button
Tilopay listed under Payment Gateways in the PayLexer dashboard with the Configure button

Enter your credentials

Paste the API User, API Password and Integration Key you copied from Tilopay into the corresponding fields.

Tilopay credential fields for API User, API Password and Integration Key in PayLexer
Tilopay credential fields for API User, API Password and Integration Key in PayLexer

Understanding Live/Production and Sandbox Settings:

EnvironmentPurpose
Live / ProductionUsed for real transactions.
Test / SandboxUsed 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.

Verify Connection and Save Changes buttons on the Tilopay configuration page in PayLexer
Verify Connection and Save Changes buttons on the Tilopay configuration page in PayLexer

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.

Websites list in the PayLexer dashboard with the Edit icon in the Actions column
Websites list in the PayLexer dashboard with the Edit icon in the Actions column

Enable Tilopay

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

Tilopay checkbox ticked in the Payment gateways tab with the Save gateways button
Tilopay checkbox ticked in the Payment gateways tab with the Save gateways button

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?