Frequently Asked Questions (FAQ)
Quick answers to common questions about Paysera Transfer API.
Use the tabs below to find answers by category. Click any question to expand the answer.
- 🔰 General
- 🔧 Integration
- 💻 Technical
- ⚠️ Troubleshooting
- 💬 Support
General Questions
What is Paysera Transfer API?
Transfer API enables you to:
- Initiate transfers between Paysera accounts
- Make bank transfers to external accounts
- Track transfer status in real-time
- Receive callback notifications about status changes
Key Features:
- MAC or SSL certificate authentication
- Multiple currency support
- Real-time status updates
- Callback webhooks
Is there a test environment?
No, Transfers API does not have a Sandbox environment.
Environments:
- Production:
https://wallet.paysera.com/transfer/rest/v1
What currencies are supported?
Transfer API supports 20+ currencies including:
- EUR - Euro
- USD - US Dollar
- GBP - British Pound
- PLN, CZK, RON and more
Contact Paysera for the complete list of supported currencies.
Integration Questions
What authentication methods are available?
Two authentication methods:
1. MAC Authentication (Recommended)
- HMAC-based request signing
- Simpler to implement
- Requires
client_idandmac_key
2. SSL Client Certificate
- Most secure option
- Uses client SSL certificates
- No shared secrets
Which programming languages can I use?
Official libraries:
- ✅ PHP - lib-transfer-client
- ✅ .NET: dotnet-lib-rest-client-common
DIY Integration: Any language with HTTP client: Python, Node.js, Java, Ruby, Go, C#
Requirements:
- HTTP client library
- JSON parsing
- HMAC-SHA256 implementation
- Base64 encoding/decoding
Do I need to handle callbacks?
Callbacks are highly recommended but optional.
Why use callbacks:
- ✅ Real-time status updates
- ✅ Don't need to poll API
- ✅ Immediate notifications
- ✅ Know when transfers fail
Technical Questions
What are the transfer statuses?
Transfer lifecycle statuses:
new- Transfer created, not yet confirmed by userwaiting- Awaiting user confirmationwaiting_funds- Insufficient balance, waiting for fundswaiting_registration- Beneficiaries not registered in systemwaiting_password- Password required for authenticationreserved- Funds reserved, ready to processdone- Transfer completed successfully ✅failed- Transfer failed due to error ❌rejected- Bank rejected the transfer ❌revoked- Client cancelled the transfer ❌
How do callbacks work?
Callbacks are HTTP POST requests from Paysera to your server.
When sent:
- Transfer status changes
- Transfer completed/failed
- User rejects/approves
Format:
- Content-Type:
application/x-www-form-urlencoded - Parameters:
transfer_id,status,date
Your response:
- Return HTTP
200for success - Return other status codes to trigger retry
Troubleshooting
Getting "Invalid MAC signature" error
Common causes:
- Wrong mac_key - Check credentials
- Incorrect calculation - Verify normalized request string
- Wrong algorithm - Use
hmac-sha-256 - Clock skew - Sync server time
Solution: Use official PHP library - it handles signing automatically!
Transfer status stuck at "reserved"
Possible reasons:
- Processing - Transfer is being processed
- Pending approval - Awaiting user confirmation
- System delay - Temporary processing delay
What to do:
- Wait for callback notification
- Check transfer status via API
- Contact support if stuck >24 hours
Support
Need help with complex integrations?
Contact: tech_support@paysera.com
Still have questions?
Can't find what you're looking for?
- 📧 Email: tech_support@paysera.com
- 📖 Documentation: Transfer API
- 🌐 Business Inquiries: support@paysera.com