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

​
Request fields for Transbank

Send these fields in the authorize request, in addition to the standard authorize fields. Required fields must be present for the payment to succeed. Payrails sends Optional fields to Transbank when you include them. For more about meta fields, refer to Meta fields. Transbank needs no meta fields. Payrails builds the buy order and session from the payment.

​
Configure Transbank settings

Some Transbank integration settings change how Payrails processes your payments. The portal shows the same description when you hover over each setting.

​
Manual capture enabled

Turn on Manual capture enabled if your Transbank commerce code uses deferred capture. Payrails then treats each WebPay Plus payment as authorized, and you capture it later with a capture request. With the setting off, Payrails treats each payment as captured straight away. Match the setting to your commerce code. The commerce code sets whether Transbank holds the funds or captures them.

​
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 October 16, 2026