🚀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
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 }
Updated 33 minutes ago