Developers
Built for developers
RESTful API. OpenAPI 3.0 spec. SDKs for every language. Process your first payment in minutes.
Quick start
Create a payment in a single API call.
curl -X POST https://api.perfectpay.ai/v2/payments \
-H "Authorization: Bearer sk_live_..." \
-H "Content-Type: application/json" \
-d '{
"amount": 5000,
"currency": "usd",
"payment_method": "card",
"routing": "smart"
}'SDKs for every stack
Official client libraries maintained by the PerfectPay team.
API features
Everything you need to build world-class payment experiences.
OpenAPI 3.0
Full spec with interactive docs. Import into Postman, Insomnia, or generate clients automatically.
Webhooks
Real-time event notifications with automatic retries, signature verification, and delivery logs.
Idempotency
Safe retries built-in. Every mutating endpoint supports idempotency keys to prevent duplicate operations.
Smart Routing API
Programmatic routing rules. Define processor priority, volume splits, and fallback logic via API.
Agent Commerce API
ACP/UCP protocol endpoints for AI agent payment initiation, authorization, and settlement.
Sandbox
Full test environment with simulated processors, test cards, and webhook event replay.
Documentation
Comprehensive guides, references, and examples.
API Reference
Complete endpoint documentation with request/response schemas.
Quick Start Guide
Process your first payment in under 5 minutes.
Web SDK
Embed hosted checkout in your site with PerfectLoader.js.
Webhooks Guide
Set up and verify real-time event notifications.
Agent Commerce Docs
Integrate AI agent payments with UCP/MCP protocols.
Stop overpaying.
Start settling instantly.
Join the merchants, platforms, and developers switching to smarter payments infrastructure.