FurlPay Docs
Open App
  • Introduction
  • Quickstart
  • For AI Agents
  • Monorepo
  • API Routes
  • Authenticationnew
  • Webhook Eventsnew
  • Error Codesnew
  • Rate Limitsnew
  • Agentic Payments (x402)
  • Agent Trust & Mandates (TAP)
  • CCTP Cross-Chainnew
  • LI.FI Swapsnew
  • FurlPay Travels (Travel MCP)
  • Solana Actions & Blinks
  • Claude Connectornew
  • AI Assistants
  • Stripe Crypto
  • Persona KYC
  • MiCA Roadmap
  • Security Posturenew
  • MPC & WebAuthn
  • Help Centernew
  • Getting Started
  • KYC Verification
  • Passkeys & Biometrics
  • Privacy & Data Protection
  • Transaction Statuses
  • Gasless Transfers
  • Deposits & Withdrawals
  • Managing Virtual Cards
  • Freezing & Unfreezing Cards
  • Declined Transactions
  • SDK & API Support
  • x402 Monetization Basics
  • Booking Travel
  • Travel Refunds & Cancellations

Resources

  • Changelog
  • System Status
  • OpenAPI Spec
  • Community
  • GitHub
Docs/Getting Started/Quickstart

Getting Started

Quickstart

Go from an empty folder to a live, webhook-driven integration in under five minutes.

1. Install the CLI

The @furlpay/cli scaffolds projects, tails logs and forwards webhooks. Run it withnpx or install it globally.

bash
npm i -g @furlpay/cli

furlpay login          # opens a browser to authorize the CLI
furlpay init my-app    # scaffold a Next.js + @furlpay/node project

2. Make your first call

import { Furlpay } from '@furlpay/node';

const client = new Furlpay(process.env.FURLPAY_SECRET_KEY!);

const order = await client.investing.order({
  symbol: 'AAPL',
  side: 'buy',
  notional: 25_00, // $25.00 in minor units — fractional via Alpaca
});

3. Forward webhooks with furlpay listen

During development, forward live events to your local server. The CLI prints a signing secret so you can verify payloads.

bash
furlpay listen --forward-to localhost:3000/api/webhooks/furlpay

# ready — forwarding events
# whsec_… (use this to verify signatures)

4. Drop in the checkout widget

Add stablecoin checkout to any React app with the FurlpayCheckoutButton Element from@furlpay/react.

tsx
import { FurlpayCheckoutButton } from '@furlpay/react';

<FurlpayCheckoutButton
  amount={49_99}
  currency="USDC"
  onSuccess={(tx) => console.log('settled', tx.id)}
/>;

Verify every webhook

Always check the Furlpay-Signature header before trusting an event. See API Routes → Webhooks for the HMAC verification snippet.
  • Explore every endpoint in API Routes.
  • Understand the repo in Monorepo.
Did this page help?
Edit this page on GitHub

← Previous

Introduction

Next →

For AI Agents