Start developing
Use this page to move from account setup to a working Paypercut integration. It groups the developer tasks that usually happen before you choose a product-specific guide.
Development checklist
- Create a sandbox account and get access to the Merchant Dashboard.
- Create sandbox API keys.
- Make your first API request from a server-side environment.
- Configure a webhook endpoint and verify signatures.
- Test successful payments, declines, authentication flows, and idempotent retries.
- Review the API resource model before building custom flows.
- Complete the go-live checklist before switching to production keys.
Core development resources
First API request
Most integrations start by creating a Checkout Session from your backend. The response includes a checkout URL that you redirect the customer to or render in an embedded flow.
curl https://api.paypercut.io/v1/checkouts \
-X POST \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_SECRET_TOKEN" \
-d '{
"currency": "eur",
"mode": "payment",
"success_url": "https://merchant.example.com/success",
"cancel_url": "https://merchant.example.com/cancel",
"line_items": [
{
"name": "Starter plan",
"quantity": 1,
"unit_price": 1000
}
]
}'
Use sandbox keys while developing. Use production keys only after onboarding is approved and your go-live checks are complete.
Release phases
| Phase | Goal |
|---|---|
| Sandbox setup | Create keys, configure webhook endpoints, and confirm basic requests work. |
| Integration build | Implement checkout, webhook handling, error handling, and reconciliation. |
| Test coverage | Run success, decline, authentication, timeout, and retry scenarios. |
| Production readiness | Complete account onboarding, confirm payment methods, and create production keys. |
| Controlled launch | Process a small live payment and verify dashboard, webhook, and fulfillment behavior end to end. |
