Add Stripe Balance API integration

[Copilot]

Implements Stripe Balance.retrieve() functionality per problem statement, enabling balance retrieval with optional context parameter for connected accounts.

Changes

Service Layer

• src/services/stripeService.js - Stripe client initialization and balance retrieval with optional stripeAccount context

API Layer

• src/api/controllers/stripeController.js - Balance endpoint controller
• src/api/routes/stripe.js - GET /api/stripe/balance?context=<account_id> route
• src/api/server.js - Route registration

Bot Integration

• src/bot/commands/stripe_balance.js - /stripe_balance command with multi-currency display
• src/bot/index.js - Command registration
• src/bot/commands/help.js - Documentation update

Configuration

• .env.example - Added STRIPE_SECRET_KEY and STRIPE_CONTEXT
• src/config/index.js - Stripe config loading
• package.json - Added stripe@^14.10.0 dependency

Usage

// Service usage
const balance = await stripeService.getBalance(context);

// API endpoint
GET /api/stripe/balance?context=acct_xxxxx

// Telegram bot
/stripe_balance

Response format includes available/pending balances per currency and livemode flag.

Original prompt

Set your secret key. Remember to switch to your live secret key in production.

See your keys here: https://dashboard.stripe.com/apikeys

import stripe
stripe.api_key = "{{ORG_SECRET_KEY}}"

balance = stripe.Balance.retrieve(stripe_context="{{CONTEXT}}")

---

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

[johnconstant99-dev]

@copilot package.json:30 "axios": "^1.12.0"

[Copilot]

@copilot package.json:30 "axios": "^1.12.0"

The axios dependency was already present in the repository before my changes. My new /stripe_balance command uses axios to call the API endpoint.

Would you like me to:

1. Update axios to the latest version (1.13.2)?
2. Keep it as is?
3. Something else?

Please let me know what you'd prefer.

[johnconstant99-dev]

lunaelite.js

[Copilot]

lunaelite.js

Could you clarify what you'd like me to do regarding "lunaelite.js"? I don't see this file in the repository or understand how it relates to the Stripe integration changes.

Are you asking me to:

• Create a new file?
• Look at an external reference?
• Something else?

[johnconstant99-dev]

@copilot src/api/controllers/stripeController.js:14

[Copilot]

@copilot src/api/controllers/stripeController.js:14

Line 14 is the closing brace of module.exports. Could you clarify what you'd like me to address?

Possible improvements I can make:

1. Add input validation for the context parameter
2. Add more detailed error handling
3. Ensure consistent response format with other controllers
4. Something else?

Please let me know what changes you'd like to see.

[johnconstant99-dev]

@copilot package.json:30

[johnconstant99-dev]

@copilot add package.json:31

[Copilot]

@copilot add package.json:31

Line 31 currently contains "stripe": "^14.10.0" which is the Stripe dependency I added.

Could you clarify what you'd like me to add at line 31? Are you asking me to:

1. Add a new dependency after Stripe?
2. Modify the Stripe dependency?
3. Add something else?

Please provide more details so I can make the appropriate changes.

[johnconstant99-dev]

@copilot del "axios": "^1.12.0"

[johnconstant99-dev]

@copilot del "axios": "^1.12.0"

[Copilot]

@copilot del "axios": "^1.12.0"

⚠️ Cannot remove axios - it's a critical dependency used throughout the application.

Axios is used by:

• src/bot/commands/balance.js (existing)
• src/bot/commands/transactions.js (existing)
• src/bot/commands/link.js (existing)
• src/bot/commands/stripe_balance.js (my new command)

Removing axios would break all bot commands that communicate with the API server.

If you're concerned about the version (1.12.0), I can update it to the latest (1.13.2), but the dependency itself cannot be removed without replacing it with an alternative HTTP client throughout the codebase.

[johnconstant99-dev]

mk_1SrXwZCJIdnOmJ9tjmXhfHKa