Docs / Get started / Quickstart

Quickstart

Take your first stablecoin payment in under five minutes. Create a session, redirect to hosted checkout, and confirm the payment with a signed webhook — across any of twenty chains.

Before you begin

You'll need a Plaidly account and a test API key from the dashboard. Everything here runs in sandbox — no real funds, faucet links included. Swap to a live key when you're ready.

Keep secret keys server-side. Never ship a sk_ key to the browser. The publishable pk_ key is safe for client use.

1 · Install the SDK

terminalCopy

# npm · also on PyPI, pkg.go.dev, Packagist
npm install @plaidly/node

2 · Create a payment session

A session is the core object: an amount, a settlement stablecoin, and the chains you'll accept. Plaidly returns a hosted checkout_url.

create-session.tsCopy

import { Plaidly } from "@plaidly/node";

const plaidly = new Plaidly({ apiKey: process.env.PLAIDLY_KEY });

const session = await plaidly.sessions.create({
  amount: "25.00",
  currency: "USD",
  settlement: "USDC",
  chains: ["base", "solana", "ethereum"],
});

redirect(session.checkout_url);

3 · Confirm with a webhook

When the payment clears on-chain, Plaidly sends a signed payment.confirmed event. Verify the HMAC signature, then fulfil the order.

Register your endpoint

Add an HTTPS URL under Developer → Webhooks. Copy the signing secret.

Verify the signature

Use plaidly.webhooks.verify() with the raw body and plaidly-signature header.

Fulfil the order

On payment.confirmed, grant access. Events are idempotent and retried up to 5×.

Next steps

Explore hosted checkout customization, the full chains reference, and payouts to sweep settled funds to cold storage.