API Reference

🚀Introduction

Welcome !

📝 Overview

The Wallet Manager API is a robust and secure solution for managing digital wallets and executing financial operations. Designed for businesses operating as payment facilitators, it provides full control over the transaction lifecycle — from wallet creation to funds settlement.

With this API, you can:

  • Create digital wallets linked to customer accounts
  • Process credit card payments
  • Initiate PIX transfers
  • Generate custom payment links

The Wallet Manager API is built with a strong focus on security, scalability, and compliance, leveraging OAuth2 authentication via Amazon Cognito and a cloud-based infrastructure with high availability.


🚦 Getting Access

To begin using the Wallet Manager API, you must request the following credentials from our technical team:

  • entity_uuid — Internal identifier for the customer account within the A55 environment. Required to create digital wallets.
  • merchant_uuid — Unique identifier for the merchant associated with the account. Required for transaction registration and processing.
  • client_id — Public identifier of the application in Amazon Cognito. Used during authentication and token issuance.
  • client_secret — Secret key linked to the client_id. Must be stored securely and never exposed in client-side code.

ℹ️ Note
To request access, please contact our technical support team at [email protected].
Our team will guide you through the onboarding process and help with environment setup.


📚 Glossary

TermDescription
entity_uuidUnique ID of the end-customer account. Required to create wallets.
merchant_uuidUnique ID of the merchant associated with the account. Used for transactions.
client_idPublic identifier used for authentication with Cognito.
client_secretPrivate key used with client_id for secure authentication.
wallet_uuidUnique ID of the wallet associated with the account. Used for managing funds.

📊 Entity Diagram

The following diagram illustrates the relationships between key entities in the Wallet Manager API:

erDiagram
    ACCOUNT ||--o{ MERCHANT : owns
    ACCOUNT ||--o{ WALLET : owns
    MERCHANT ||--o{ CHARGE : creates
    WALLET ||--o{ CHARGE : manages

    ACCOUNT {
        string account_uuid
        string name
    }
    MERCHANT {
        string merchant_uuid
        string soft_description
    }
    WALLET {
        string wallet_uuid
        string currency
        float balance
    }
    CHARGE {
        string charge_uuid
        string wallet_uuid
        string merchant_uuid
    }