Skip to main content

Getting Started with Transfer API

Welcome to the Transfer API! This guide will walk you through the steps needed to start making transfers between Paysera accounts and bank accounts.

Prerequisites​

Before you begin, make sure you understand:

  • What the Transfer API does: Enables you to initiate transfers between Paysera accounts and bank accounts
  • Basic HTTP/REST concepts: You'll be making HTTP requests to our API
  • Authentication requirements: You'll need to use MAC authentication or SSL certificates

Step-by-Step Guide​

Step 1: Read the Documentation​

First, familiarize yourself with the Transfer API capabilities and requirements:

tip

Take time to understand the authentication process - it's the most critical part of integration.

Step 2: Get a Paysera Account​

You need a Paysera account to use the Transfer API:

  1. Register at Paysera
  2. Complete the account verification process
  3. This will be your production environment for live transactions

Step 3: Sign an Agreement​

Contact Paysera to initiate the onboarding process:

  1. Contact Information:

    • Email: Paysera client support
    • Provide description of your intended use case

  2. Information to Provide:

    • How you plan to use the Transfer API
    • Which environment (Production or Sandbox)
    • Expected transaction volumes
    • Your business details

  3. Agreement Process:

    • Paysera will send you the necessary agreements
    • Review and sign the agreements
    • Wait for confirmation
Agreement Required

Signing an agreement is mandatory to use the Transfer API in production.

What happens next:

  • Paysera reviews your application
  • You may be asked for additional information
  • Once approved, you'll move to Step 4

Step 4: Get API Client Configured​

Once your agreement is signed, you need to get your API credentials:

Choose Authentication Method​

You have two options:

Option A: MAC Authentication (Recommended)
  • Simpler to implement
  • Credentials provided by Paysera
  • You'll receive:
    • client_id - Your unique identifier
    • mac_key - Secret key for signing requests
    • mac_algorithm - Algorithm to use (typically hmac-sha-256)
Option B: SSL Client Certificate
  • More secure
  • You generate and provide the certificate
  • No shared secrets
  • Requires SSL/TLS configuration
info

Read the Authentication documentation to understand both methods before choosing.

Request Your Credentials​

  1. Inform Paysera of your chosen authentication method
  2. Provide necessary information:
    • For MAC: Paysera will generate credentials for you
    • For SSL: You need to provide your certificate request (CSR)
  3. Wait for configuration - typically takes a few business days
  4. Receive credentials via secure channel
Credentials Security
  • Never share your mac_key or private keys
  • Store credentials securely (environment variables, secret management)
  • Don't commit credentials to version control
  • Keep all credentials absolutely secure

Important Notes:​

  • Credentials are provided by Paysera after agreement signing
  • Credentials cannot be self-configured
  • Keep your credentials secure at all times
What's Next?

Once you have your credentials, you're ready to start integrating:

1. Set Up Your Development Environment​

# Example environment variables
PAYSERA_CLIENT_ID=your_client_id
PAYSERA_MAC_KEY=your_mac_key
PAYSERA_API_URL=https://wallet.paysera.com/transfer/rest/v1

2. Make Your First API Call​

Test your authentication by making a simple GET request to verify your credentials work.

3. Explore Use Cases​

Check out our Examples to see common integration patterns.

4. Understand Callbacks​

Learn how to handle transfer status updates via Callbacks.

5. Use Libraries (Optional)​

Consider using our official libraries to simplify integration:

Need Help?​

Support Channels​

  • Technical Questions: Contact Paysera technical support
  • Account Issues: Contact Paysera client support
  • Documentation: Check this developer portal
Common First Steps Issues

Problem: Can't get credentials
Solution: Make sure you've signed an agreement for Production

Problem: Credentials don't work
Solution: Verify you're using the correct environment (Sandbox vs Production)

Problem: MAC authentication fails
Solution: Check the Authentication guide and verify your MAC calculation

Timeline Expectations​

StepTypical Duration
Account RegistrationImmediate - 1 day
Agreement Signing1-5 business days
Credential Configuration2-3 business days
Total3-9 business days

Ready to dive deeper?