Skip to main content

Obtaining API Credentials

Follow these steps to set up your Wallet API access and obtain the necessary credentials for integration.

Prerequisites

Before starting, make sure you understand the API terminology and key terms in the Overview page.

Step 1: Read the Documentation​

First, read through the documentation to ensure the Wallet API is the right tool for your needs.

Key Documentation to Review:

Step 2: Get a Paysera Account​

How to Register:

  1. Visit Paysera Registration
  2. Complete the registration form
  3. Verify your email address
  4. Complete identity verification (KYC)
Production Environment

Wallet API operates in production environment only. All testing is done with real transactions, so plan carefully and use small amounts for testing.

Step 3: Sign an Agreement​

Contact Paysera to initiate the API access process.

What to Provide:

When contacting Paysera, include:

  1. API Usage Description

    • Detailed explanation of how you plan to use the API
    • Use cases and business requirements
    • Expected transaction volumes

  2. API Endpoints

    • Which Wallet API endpoints you'll use
    • Specific features required

  3. Timeline

    • When you plan to go live
    • Expected integration completion date

  4. Technical Contact

    • Email address for receiving credentials
    • Technical contact person
Agreement Required

Production environment access requires a signed agreement. Without an agreement, you will not be able to use the API.

How to Contact:

Email: tech_support@paysera.com

Subject: Wallet API - Agreement Request

Include:

  • Company information
  • API usage description
  • Requested environment(s)
  • Technical contact details

Step 4: Choose Authentication Method​

Before requesting credentials, decide which authentication method you'll use:

Option 1: MAC Access Authentication

How it works:

  • Signature-based authentication
  • Uses shared secret key
  • Secret never sent with requests
  • Always used for access tokens

Learn more about MAC Authentication →

Option 2: SSL Client Certificate

How it works:

  • Certificate-based authentication
  • Uses client certificate and private key
  • Secret never shared with Paysera
  • Requires certificate request setup

Learn more about SSL Certificate Authentication →

Step 5: Receive Your Credentials​

Once you've chosen your authentication method:

  1. Inform Paysera

    • Email your authentication method choice
    • Provide any required information (e.g., certificate request for SSL)

  2. Wait for Configuration

    • API client setup takes time
    • Paysera will configure your access

  3. Receive Credentials

    • Credentials will be sent to your specified email
    • Production credentials for live use

What You'll Receive:

For MAC Authentication:

client_id:     wkVd93h2uS
mac_key:       IrdTc8uQodU7PRpLzzLTW6wqZAO6tAMU
mac_algorithm: hmac-sha-256

For SSL Certificate:

  • Signed certificate file
  • Instructions for implementation
Keep Credentials Secure

Never share your credentials publicly or commit them to version control. Store them securely and treat them like passwords.

Step 6: Test Your Integration​

Once you receive your credentials:

  1. Start with Small Amounts

    • Begin testing with minimal transaction values
    • Verify all functionality works
    • Test error handling thoroughly

  2. Review Security

    • Ensure HTTPS is used for all requests
    • Verify server certificate validation
    • Implement proper error handling

  3. Test Authentication

    • Verify credentials work correctly
    • Test token generation/validation
    • Ensure proper header construction

  4. Monitor & Go Live

    • Test thoroughly before full deployment
    • Monitor for any issues
    • Gradually increase transaction volumes
What's Next?

After obtaining your credentials:

  1. 🔐 Set Up Authentication - Implement authentication in your code
  2. 🔒 Review Security Best Practices - Ensure secure implementation
  3. 📖 Explore API Fundamentals - Learn core API concepts
  4. 💡 View Code Examples - See implementation examples

Support​

Need help with complex integrations?

Contact: tech_support@paysera.com