Pix Automático via dLocal

Get started with Pix Automático via dLocal

Before you begin

Configure in the Dashboard

1. Add Pix Automático via dLocal payment method to your Dashboard Go to the integrations section of the Dashboard, click on the ‘New Integration’ button and search for dLocal. Enter your x_login, x_trans_key and secret key, then click Connect.
2. Add your MID Enter your dLocal AccountId in the MID box. You can find it at the top of the dLocal dashboard.
3. Configure the webhooks in dLocal Copy the callback URL that Primer shows you during setup. In the dLocal dashboard, under Endpoint configuration, paste it into both the Refunds URL field and the Payins notification URL field. The Payins notification URL is required for Pix Automático.
4. Activate Pix Automático via dLocal on the Checkout Go to the Checkout section of the Dashboard and toggle on Pix Automático. Add a display condition so it only appears where it can be paid — at a minimum, Currency = BRL.
5. Configure a Workflow to process payments made with Pix Automático via dLocal Go to Workflows and create a workflow with a Payment created trigger and an Authorize payment action with Auto-continue enabled. Pix Automático via dLocal is a web redirect connection, so no further steps are needed.

Prepare the client session

Enrolment and initial payment

{
  "subscription": {
    "frequency": "MONTHLY",
    "amount": {
      "type": "VARIABLE",
      "minValue": 200
    },
    "startDate": "2025-08-04",
    "endDate": "2025-12-01"
  }
}

Recurring payments

{
  "scheduled_date": "2025-10-04"
}

Automatic retries

Prepare the SDK for payments

<primer-checkout client-token="your-client-token"></primer-checkout>

<primer-checkout client-token="your-client-token">
  <primer-main slot="main">
    <div slot="payments">
      <primer-payment-method type="YOUR_PAYMENT_METHOD_TYPE"></primer-payment-method>
    </div>
  </primer-main>
</primer-checkout>

const options = {
  container: "#checkout-container",
  redirect: {
    returnUrl: "https://mystore.com/checkout",
  },
  onCheckoutComplete({ payment }) {
    console.log("Checkout complete.", payment);
  },
};

import { Primer } from "@primer-io/checkout-web";

try {
  await Primer.showUniversalCheckout(clientToken, options);
} catch (e) {
  // handle error
}

const manager = await headless.createPaymentMethodManager("YOUR_PAYMENT_METHOD_TYPE");

if (manager) {
  manager.addEventListener("click", () => {
    // Optional: run custom logic before the redirect flow starts.
  });

  await manager.start();
}

let settings = PrimerSettings(
  // ...
  paymentMethodOptions: PrimerPaymentMethodOptions(
    urlScheme: "your-url-scheme://" // e.g. primer://, yourscheme://
  )
  // ...
)

import PrimerSDK
import UIKit

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {
  // ...
  func application(
    _ application: UIApplication,
    continue userActivity: NSUserActivity,
    restorationHandler: @escaping ([UIUserActivityRestoring]?) -> Void
  ) -> Bool {
    return Primer.shared.application(
      application,
      continue: userActivity,
      restorationHandler: restorationHandler
    )
  }
}

class MyViewController: UIViewController {
  func startUniversalCheckout() {
    Primer.shared.showUniversalCheckout(clientToken: self.clientToken)
  }
}

// 👇 Create the payment method manager
let nativeUIPaymentMethodManager = try PrimerHeadlessUniversalCheckout.NativeUIManager(
  paymentMethodType: "YOUR_PAYMENT_METHOD_TYPE"
)

// 👇 Show the payment method
try nativeUIPaymentMethodManager.showPaymentMethod(intent: .checkout)

class CheckoutActivity : AppCompatActivity() {
  private fun setupObservers() {
    viewModel.clientToken.observe(this) { clientToken ->
      showUniversalCheckout(clientToken)
    }
  }

  private fun showUniversalCheckout(clientToken: String) {
    Primer.instance.showUniversalCheckout(this, clientToken)
  }
}

// 👇 Create the payment method manager
val nativeUiManager = PrimerHeadlessUniversalCheckoutNativeUiManager.newInstance("YOUR_PAYMENT_METHOD_TYPE")

// 👇 Show the payment method
nativeUiManager.showPaymentMethod(this, PrimerSessionIntent.CHECKOUT)

Test in sandbox

Go live