Guides
Go to payrails.com

PagaLeve

A step-by-step guide for setting up your PagaLeve payments integration in the Payrails portal.

📘

Who should use this guide

This 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
  • Want to accept payments through PagaLeve's hosted checkout page

PagaLeve uses a hosted checkout (redirect) integration: your shopper is redirected 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

Following are the initial 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 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 PagaLeve and continue to the next step.

Step 3: Configure your PagaLeve integration

📋

What you'll need from PagaLeve

Before 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, as it is used in routing.

In Payrails

  • Enter an Instance name for your integration.

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.

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.
ℹ️

Notifications: Payrails sends the notification (webhook) URL to PagaLeve automatically with every checkout, so there is 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

Updated 2 days ago

Did this page help you?