Skip to main content
Who should use this guideThis guide is intended for merchants who:
  • Use Payrails as a payment orchestrator
  • Use Transbank (WebPay Plus) to accept payments in Chile
  • Accept card payments through WebPay’s hosted payment page
WebPay Plus uses a hosted payment page (redirect) integration: your shopper goes to Transbank to enter card details and complete authentication, so raw card data never passes through your checkout.

​
Create and configure a Transbank integration in Payrails

Follow these steps to set up Transbank:
  1. Log in to the Payrails portal.
  2. Go to Settings → Integrations → Payments.
  3. Select Add instance to create a new Transbank integration configuration.
  4. Select the workspaces where this integration should be available.
About workspacesWorkspaces 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. Payrails provider selection set to Transbank

​
Step 3: Configure your Transbank integration

What you’ll need from TransbankBefore 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, since it’s used in routing.
In Payrails
  • Enter an Instance name for your integration.
Payrails integration instance name field for Transbank

​
Commerce Code & Secret Key

From your Transbank account manager
  • Obtain your Commerce Code & Secret Key.
In Payrails
  • Paste the values into the Commerce Code and Secret Key fields.
Payrails Commerce Code and Secret Key fields for Transbank

​
Payment methods

In Payrails
  • Under Payment methods, enable WebPay.
Payrails payment methods section with WebPay enabled

​
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

  1. Run a test payment in test mode using a Transbank test card. Use a supported currency such as CLP.
  2. Verify that:
    • The payment appears in your Transbank account.
    • The payment status updates correctly in Payrails.
  3. Once verified in test mode, repeat the setup in live mode.
Continue to: Test a payment
Last modified on September 28, 2026