PerfectPay Documentation

Use these docs to launch checkout, save payment methods, manage refunds, wire webhooks, and roll out agent-commerce flows with PerfectPay.

Start Here

The core payment APIs for customers, payments, payment methods, refunds, subscriptions, and webhooks
Hosted checkout guidance for the Web SDK served from sdk.perfectpay.ai
Product guides for payment rails, 3DS, webhooks, instant QR, smart routing, connectors, split payments, payouts, instant settlement, customer-present, fraud prevention, disputes, and mandates
Solution guides for marketplaces, subscriptions, gig economy, and restricted industries
Agent-commerce documentation for UCP, MCP tools, and hosted agents

Track	What you will find
API	Customer creation, payments, saved payment methods, refunds, subscriptions, and events
Web SDK	Hosted checkout embedding with `PerfectLoader.js` and `window.Perfect(...)`
Guides	Payment rails, 3DS, webhooks, instant QR, smart routing, connectors, split payments, payouts, instant settlement, customer-present, fraud prevention, disputes, and mandates
Solutions	Marketplaces, subscriptions, gig economy, and restricted industries
Agent Commerce	UCP REST endpoints, MCP tools, hosted buyer and seller agent flows

Use the dashboard as the control plane for credentials and profile data:

Developers -> API Keys for secret keys and publishable keys
Developers -> Settings for profile ids, environment-specific settings, and hosted SDK details