Transbank

📘
Who should use this guide
This guide is intended for merchants who:

Use Payrails as a payment orchestrator

Use Transbank (WebPay Plus) to accept payments in Chile

Want to accept card payments through WebPay's hosted payment page

WebPay Plus uses a hosted payment page (redirect) integration: your shopper is redirected to Transbank to enter their card details and complete authentication, so raw card data never passes through your checkout.

Create and configure a Transbank integration in Payrails

Following are the initial steps to set up Transbank:

Log in to the Payrails portal.
Go to Settings → Integrations → Payments.
Select Add instance to create a new Transbank integration configuration.
Select the workspaces where this integration should be available.

About workspaces

Workspaces determine where this integration is available. They let you isolate provider setups by region or business line, or share the same configuration across multiple workspaces.

Step 2: Choose the provider

Select Transbank and continue to the next step.

Step 3: Configure your Transbank integration

📋
What you'll need from Transbank
Before you begin, make sure you have the following information from your Transbank account manager:

Commerce Code

Secret Key (used to authenticate requests to Transbank's API)

Integration instance name

An integration instance is a specific payment provider setup in Payrails. You can create multiple instances for each provider based on region, currency, or business needs. Choose a clear, consistent name, as it is used in routing.

In Payrails

Enter an Instance name for your integration.

Commerce Code & Secret Key

From your Transbank account manager

Obtain your Commerce Code & Secret Key.

In Payrails

Paste the value into the Code Commerce Code & Secret Key fields.

Payment methods

In Payrails

Under Payment methods, enable WebPay.

Enable the integration

In Payrails

Select Save account to save the configuration and enable the integration.
The Enabled status confirms that the Transbank integration is active.

Your Transbank integration is now ready to process payments.

Next steps

Run a test payment in test mode using a Transbank test card. Use a supported currency such as CLP.
Verify that:
- The payment appears in your Transbank account.
- The payment status updates correctly in Payrails.
Once verified in test mode, repeat the setup in live mode.

→ Continue to: Test a payment