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

Getting Started

Furlpay Developer Quickstart

Welcome to the Furlpay API. Integrate global stablecoin checkouts and fractional stock investments with a few lines of code — on a compliance-aware, phishing-resistant, zero-gas rail.

Furlpay is an on-chain financial operating system: stablecoin payments, local bank accounts, card issuance and fractional investing behind one API and a set of typed SDKs. Everything you can do in the app, you can do programmatically.

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

const client = new Furlpay('sk_test_123');

const card = await client.cards.issue({
  holder: 'usr_9f2c31',
  currency: 'USDC',
  spendLimit: 500_00, // minor units
});

The system at a glance

Every client — human or agent — hits the same Next.js API surface; payments settle non-custodially on public chains, with durable state split between Postgres and Redis:

Rendering diagram…
System context: clients, payment rails, platform services, state, and external networks.

What you can build

  • Accept stablecoin checkouts with the FurlpayCheckoutButton React Element.
  • Issue 2-of-2 MPC virtual cards and control them via POST /api/cards/settings.
  • Open local IBAN / routing accounts and move money across rails.
  • Place fractional stock & ETF orders via POST /api/investing/order.
  • Give an AI agent a wallet — MCP server, LangChain tools, x402 pay-per-call and TAP-style spend mandates. Start at For AI Agents.

API keys

Test keys are prefixed sk_test_ and live keys sk_live_. Keep secret keys server-side only; the browser never sees them. Publishable keys (pk_) render Elements and are safe to expose.

Next: install the CLI

The fastest path from zero to a live webhook is the Furlpay CLI. Head to the Quickstart to scaffold a project and forward events to localhost.
Did this page help?
Edit this page on GitHub

Next →

Quickstart