Integration Steps
1
→
2
Order Payment Service
Order "Online payment collection via e-banking and other systems" service.
Settings → Profile Settings → Service management→
3
Create a Project
Navigate to "Project and Activities" → "My projects" and create a new project.
Get your project_id and project_password→
4
Add Website to Project
Add your website domain to the project settings for security.
Project settings → General project information→
5
Confirm Website Ownership
Verify your website ownership using the provided ownership code.
Contact tech_support@paysera.com if needed→
6
Integrate
Use your credentials to integrate the Checkout API.
Complete integration and start accepting paymentsIntegration Examples
API Endpoint
Production:
https://www.paysera.com/pay/Method: GET or POST
Authentication: MD5 signature-based (not Bearer token)
Required Parameters
| Parameter | Type | Description |
|---|---|---|
projectid | integer | Your unique project ID from Paysera system |
orderid | string | Unique order number from your system (max 40 chars) |
amount | integer | Payment amount in cents (e.g., 2500 = 25.00 EUR) |
currency | string | Payment currency code (EUR, USD, etc.) |
accepturl | string | Success redirect URL (do not rely on this for order confirmation) |
cancelurl | string | Cancel redirect URL |
callbackurl | string | Webhook URL for payment notifications (must return "OK") |
version | string | API version ("1.8" or "1.9") |
sign | string | MD5 signature for security |
Important Notes
- 💰 Amounts in cents: Always specify payment amounts in the smallest currency unit (e.g., 2500 = 25.00 EUR)
- 🔒 Signature security: NEVER calculate signature on frontend - always do this server-side to protect your project password
- ✓ Callback response: Your callback URL MUST return "OK" to acknowledge receipt
- ⚠️ Don't trust accepturl: Use callbackurl for order confirmation, not accepturl (user can manipulate redirect)
- 🧪 Test mode: Add
test=1parameter for test payments (enable in project settings) - ⏱️ Payment expiry: Payments expire after 1 hour by default
Next Steps
Read Full Documentation
Explore complete API reference, all parameters, and advanced features.
View Checkout API DocsSee More Examples
Check out real-world integration examples in multiple programming languages.
View Examples