📝 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

Term	Description
`entity_uuid`	Unique ID of the end-customer account. Required to create wallets.
`merchant_uuid`	Unique ID of the merchant associated with the account. Used for transactions.
`client_id`	Public identifier used for authentication with Cognito.
`client_secret`	Private key used with `client_id` for secure authentication.
`wallet_uuid`	Unique 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
    }