Skip to main content

Transfer API Examples

Comprehensive guides and code examples for working with the Paysera Transfer API. Each guide includes step-by-step instructions, complete code samples, and best practices.

Quick Start​

All API requests require MAC authentication. See the Authentication guide for details on how to generate MAC authorization headers.

Example Authorization Header:

Authorization: MAC id="wkVd93h2uS", ts="1343811600", nonce="nQnNaSNyubfPErjRO55yaaEYo9YZfKHN", mac="Bp22nWw9qFsz7ux5xOYkCIYJjXAz8mhxTSfJsoOKV3A="

Base URL: https://wallet.paysera.com/transfer/rest/v1

Available Guides​

⚡ Automatic Confirmation​

Create transfers that confirm automatically without user interaction:

  • Background payment processing
  • Automated payouts (commissions, royalties)
  • System-triggered transfers
  • API-only workflow
  • Real-time completion

Perfect for: Automated systems, scheduled payouts, refund processing

👤 Manual Confirmation​

User-confirmed transfers through Paysera interface:

  • Redirect to confirmation page
  • User reviews & approves
  • Return URL handling
  • Enhanced security
  • Callback notifications

Perfect for: E-commerce checkout, invoice payments, user-initiated transfers

Common Use Cases​

Code Examples​

All guides include complete, runnable code examples in:

  • JavaScript/Node.js
  • HTTP/REST requests
  • cURL commands

Authentication​

Before using any endpoints, ensure you have:

  1. MAC Authentication Credentials - Required for all API requests (client_id, mac_key, mac_algorithm)
  2. API Credentials - Provided by Paysera client support after signing agreements
  3. Account Permissions - Sufficient permissions to create transfers

For authentication details, see Authentication Guide.

Transfer Statuses​

Refer to the Transfer Lifecycle for a complete list of statuses and their descriptions.

Rate Limits​

  • Standard endpoints: 100 requests per minute
  • Batch operations: 10 requests per minute
  • Transfer queries: 100 results per page

Rate limit headers included in responses:

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 95
X-RateLimit-Reset: 1697193600

Error Handling​

All endpoints return standardized error responses:

{
  "error": "insufficient_funds",
  "error_description": "Account does not have sufficient funds",
  "available": "50.00",
  "required": "100.00",
  "currency": "EUR"
}

Common error codes:

  • invalid_request - Malformed request
  • unauthorized - Authentication failed
  • insufficient_funds - Not enough balance
  • invalid_beneficiary - Invalid recipient details
  • rate_limit_exceeded - Too many requests

Support​

Need help with complex integrations?

Contact: tech_support@paysera.com

Next Steps​

  1. Start with Creating a Transfer to understand the basics
  2. Explore Bank Transfers for external payments
  3. Learn Batch Transfers for bulk operations
  4. Review the API Reference for complete endpoint documentation