Integration Steps
Read Documentation
Review the complete Transfer API documentation to understand capabilities and requirements.
Ensure the Transfer API matches your use case requirementsGet Paysera Account
Register for a Paysera account to access the Transfer API functionality.
📹 Watch video instructionsSign Agreement
Contact Paysera to sign an agreement and describe your intended API usage.
Required for accessing Transfer APIConfigure API Client
Choose authentication method and receive your API credentials from Paysera.
Credentials are environment-specificAuthentication Methods
MAC Authentication
RecommendedUses OAuth 2.0 MAC tokens with shared secret keys. Signature-based authentication where the secret key is never sent with requests.
- HMAC-SHA256 signature calculation
- Timestamp and nonce for replay protection
- Easier to implement and manage
- Suitable for most integrations
SSL Client Certificate
AdvancedUses client-side SSL certificates for authentication. Higher security as private keys are never shared with Paysera.
- Certificate-based authentication
- Private key remains with client
- Highest security level
- Requires certificate management
Key Features
Account-to-Account Transfers
Transfer funds between your Paysera account and other Paysera accounts or external bank accounts.
RESTful API
Built on REST principles using standard HTTP verbs with JSON request/response format.
Secure Authentication
Choose between MAC authentication or SSL client certificates for maximum security.
Production Ready
Robust production environment designed for secure financial transactions and reliable operations.
Comprehensive Monitoring
Track transfer status, get detailed error responses, and monitor transaction history.
Real-time Processing
Fast transfer processing with immediate API responses and status updates.
API Overview
API Base URL
https://wallet.paysera.com/transfer/rest/v1Authentication: MAC (OAuth 2.0) or SSL Client Certificate
Key Capabilities
- 💸 Transfer Creation: Initiate transfers between Paysera accounts or to external banks
- 📊 Transfer Management: Get transfer details, list transfers, check status
- 🔄 Transfer Operations: Reserve, provide, cancel, and revoke transfers
- 🔐 Secure Authentication: MAC authentication with HMAC-SHA256 or SSL certificates
- 📝 Callbacks: Webhook notifications for transfer status changes
Main Endpoints
POST /transfers
Create a new transfer with amount, beneficiary, and purpose details.
GET /transfers/{id}
Get detailed information about a specific transfer.
GET /transfers
List transfers with optional filters (status, date range, etc.).
PUT /transfers/{id}/reserve
Reserve a transfer for later processing.
PUT /transfers/{id}/provide
Provide additional details or confirmation for a transfer.
DELETE /transfers/{id}
Cancel a pending transfer.
Important Notes
- 💰 Decimal amounts: Specify amounts as decimal strings (e.g., "100.50")
- 🔒 MAC signature: Calculate HMAC-SHA256 signature with timestamp and nonce
- 🌍 Purpose codes: Use standard banking purpose codes (e.g., TRAD, SALA)
- 📧 Beneficiary types: Support for Paysera accounts, IBANs, and more
- ⏱️ Production only: No sandbox environment - use caution during testing
- 🔔 Callbacks: Configure webhook URLs for status notifications
Complete Documentation & Examples
Transfer API Overview
Complete overview of Paysera's Transfer API capabilities and use cases.
View API Overview