Skip to main content

Wallet API Overview

The Paysera Wallet API provides comprehensive access to manage Paysera wallet accounts, user information, and payments between Paysera accounts.

What is Wallet API?​

Wallet API is composed of two different, but related features:

  1. User Information & Account Management

    • Get information about Paysera system users
    • Access user account details and balances
    • Manage account permissions

  2. Payment Operations

    • Make payments between Paysera accounts
    • Send and receive payments
    • Coordinate payment transactions

Key Terms​

Understanding these terms will help you work effectively with the Wallet API:

Client​

Your script or application that makes requests to the API. Client permissions are configurable and depend on the client type (web-based client, mobile application, physical location, etc.).

Project​

Has an owner and a default account for incoming payments. Several different clients can make requests representing the same project. Similarly, one client can sometimes represent several different projects.

User​

A registered user in the Paysera system. Can be a person or a company.

Account​

An account with a balance, belonging to a user. Users can have permissions to use accounts other than their own - this is always the case for company accounts, as only persons can access them.

Wallet​

Always related to a specific user and account. Each user can have one or more wallets with different limits and options. A wallet can be related to a card or other identifier, allowing users to have several wallets related to the same account.

Allowance, Payment & Transaction​

  • Transaction: A combination of Payment(s) and possibly an Allowance
  • Payment: Each payment has a beneficiary (wallet), usually belonging to the project
  • Allowance: User confirms the transaction by providing secret information (PIN) or in advance using an allowance

The transaction is related to a specific wallet, and its limits are used to validate payments.

Architecture Overview​

Understanding how Projects, Clients, and Wallets relate to each other:

Key Relationships:

  • User/Company owns one or more Wallets
  • Project has a default wallet for receiving payments
  • Project can have multiple Client types:
    • Private Client - Manages locations and services
    • Application Clients - Web apps, mobile apps, POS systems
  • Each Client makes API requests on behalf of the Project
  • Payments flow from payer's wallet to project's default wallet

API Endpoints​

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

All integration and testing is performed in the production environment with real transactions.

Production Only

Wallet API operates in production environment only. Plan your testing carefully with small amounts.

Getting Started​

Ready to start using the Wallet API?

  1. 📖 Obtaining Credentials - Set up your API access
  2. 🔐 Authentication - Learn authentication methods
  3. 🔒 Security - Review security requirements
  4. 🔧 API Reference - Explore available endpoints
  5. 💡 Examples - View code examples

Support​

Need help with complex integrations?

Contact: tech_support@paysera.com