Skip to content

FurlPay/furlpay-examples

Repository files navigation

Furlpay Examples

Complete, runnable examples for integrating Furlpay — stablecoin payments, wallets, cards, and AI-agent payments — in every major stack.

Clone, cd into an example, add your API key, run. Time to first payment: minutes.

git clone https://github.com/furlpay/furlpay-examples

Examples

Example Stack Shows
nextjs-checkout Next.js 15 (App Router) Server-side transfer + @furlpay/elements checkout UI
express-webhooks Node.js / Express Verified webhook handling with @furlpay/furlpay-node
python-fastapi Python / FastAPI Payments + webhook verification with the furlpay package
go-webhooks Go (stdlib only) Webhook verification with furlpay-go
rust-webhooks Rust Dependency-free signature verification with the furlpay crate
ai-agent-mcp Claude / Cursor / MCP Let AI agents drive Furlpay via furlpay-mcp-server
x402-paid-api TypeScript / x402 Charge AI agents per-request over HTTP 402 stablecoin payments

Prerequisites

  • A Furlpay API key (sk_sandbox_... for test mode)
  • A webhook endpoint secret (whsec_...) for the webhook examples

Every SDK uses the same webhook signature scheme — t=<unix>,v1=<hmac-sha256-hex> in the furlpay-signature header, 5-minute replay tolerance — so the examples are interchangeable across languages.

SDKs used

Language Package
Node.js / TypeScript @furlpay/furlpay-node
Python furlpay-python
Go github.com/furlpay/furlpay-go
Rust furlpay-rust
React UI @furlpay/elements
CLI @furlpay/cli

Local webhook testing

Use the CLI to forward events to your local server (any example on port 4242):

npx @furlpay/cli listen --forward-to localhost:4242/webhooks
npx @furlpay/cli trigger payment.settled

Questions

Open a Discussion or email hello@furlpay.com. Security reports: hello@furlpay.com — please don't open public issues.

License

MIT

About

Official Furlpay examples — Next.js, Express, FastAPI, Go, Rust, AI agents (MCP) & x402 agent payments. Clone and go.

Topics

Resources

License

Code of conduct

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors