Skip to main content
Who should use this guideThis guide is intended for merchants who:
  • Use Payrails as a payment orchestrator
  • Use PagaLeve to accept Pix Parcelado (Buy Now, Pay Later) payments in Brazil
  • Accept payments through PagaLeve’s hosted checkout page
PagaLeve uses a hosted checkout (redirect) integration: your shopper goes to PagaLeve to pay the first installment with Pix and complete the BNPL agreement, so no payment credentials pass through your checkout.

​
Create and configure a PagaLeve integration in Payrails

Follow these steps to set up PagaLeve:
  1. Log in to the Payrails portal.
  2. Go to Settings → Integrations → Payments.
  3. Select Add instance to create a new PagaLeve 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 PagaLeve and continue to the next step. Payrails provider selection set to PagaLeve

​
Step 3: Configure your PagaLeve integration

What you’ll need from PagaLeveBefore you begin, make sure you have access to your PagaLeve account and the following:
  • Public Key
  • Secret Key (used to authenticate requests to PagaLeve’s API)
  • Optional: Subsidiary ID—only needed if a holding company transacts on behalf of a subsidiary.

​
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 PagaLeve

​
Public Key & Secret Key

In PagaLeve
  • In your PagaLeve account, locate and copy your Public Key & Secret Key.
In Payrails
  • Paste the value into the Public Key & Secret Key fields.
Payrails Public Key and Secret Key fields for PagaLeve

​
Subsidiary ID (optional)

In Payrails
  • If a holding company is transacting on behalf of a subsidiary, enter the Subsidiary ID. Otherwise, leave this field blank.

​
Payment methods

In Payrails
  • Under Payment methods, enable Pix Parcelado.
Payrails sends the notification (webhook) URL to PagaLeve automatically with every checkout, so there’s no separate webhook to configure in the PagaLeve portal.

​
Enable the integration

In Payrails
  • Select Save account to save the configuration and enable the integration.
  • The Enabled status confirms that the PagaLeve integration is active.
Your PagaLeve integration is now ready to process payments.

​
Next steps

  1. Run a test payment in test mode using PagaLeve’s sandbox checkout simulator. Use a supported currency such as BRL or USD.
  2. Verify that:
    • The payment appears in your PagaLeve 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