Developer Portal
PerfectPay's developer surface is organized around a simple pattern:
- Create or look up a customer on the server.
- Create a payment with your secret key.
- Hand the client the
client_secretandpayment_id. - Confirm the payment with the hosted Web SDK or a server-side confirm call.
Recommended Build Order
| Workflow | Start with |
|---|---|
| Accept a card or wallet payment | Getting Started |
| Embed checkout in your site | Web SDK |
| Save and reuse payment methods | Payment Methods |
| Issue a refund | Refunds |
| Set up recurring billing | Subscriptions |
| Troubleshoot delivery issues | Events & Webhooks |
Rules That Apply Everywhere
- All server requests use the
api-keyheader:api-key: YOUR_SECRET_API_KEY. - All client requests also use
api-keywith a publishable key:api-key: YOUR_PUBLISHABLE_KEY. - Use the hosted Web SDK instead of sending raw card data from your own frontend.
- Copy your environment's SDK loader URL from Developers -> Settings.