API Reference

๐ŸŒEnvironment

๐ŸŒ Environment Setup

This guide explains how to configure your environments to interact with our API โ€” including test (sandbox) and production modes. Each environment uses the same endpoints but requires different credentials.


๐Ÿ”— API and Authentication Endpoints

Use the following URLs for both environments:

PurposeURL
API Base URLhttps://core-manager.a55.tech/api/v1
Auth URLhttps://smart-capital.auth.us-east-1.amazoncognito.com/oauth2/token
โš ๏ธ

While the endpoints are identical, the credentials differ per environment.


๐Ÿงช Test Environment

The Test (Sandbox) environment is used for development and validation.

  • โœ… Simulate full payment and wallet flows
  • โœ… No real funds or production data
  • โœ… Ideal for QA and integration testing

๐Ÿš€ Production Environment

The Production environment is used for real transactions.

  • ๐Ÿ” Requires proper KYC/onboarding
  • ๐Ÿ’ณ Connects to financial providers
  • ๐Ÿ“Š Generates live dashboards and reports

๐Ÿ“ How to Request Access

To request credentials for either environment, please email:

๐Ÿ“ง [email protected]

Include the following:

  • Company name and CNPJ
  • Contact email and responsible person
  • Intended usage (Test / Production)
  • Platform or project URL

โœ… Best Practices

  • Begin in test before switching to production
  • Never use production credentials in staging/dev
  • Store secrets safely โ€” never expose client_secret in frontend
  • All requests must be made over HTTPS
  • When in doubt, reach out: [email protected]