moveme_wallet 0.1.0

SDK Dart/Flutter for MoveMe Digital Wallet (accounts, balance, debit, transfer, loads).

moveme_wallet

SDK Dart/Flutter para a Carteira Digital MoveMe (/api/digital-wallet).

Install

dependencies:
  moveme_wallet: ^0.1.0

Quick start

import 'package:moveme_wallet/moveme_wallet.dart';

final client = DigitalWalletClient(
  config: WalletConfig(
    baseUrl: 'YOUR_BASE_URL',
    apiKey: 'YOUR_API_KEY',
  ),
);

final account = await client.createAccount(externalUserId: 'moveme:driver_42');
final balance = await client.getBalance(account.id);

await client.debit(
  externalUserId: 'moveme:driver_42',
  amount: 100,
  idempotencyKey: 'trip:99:fare',
);

API

Method	Auth
createAccount, getBalance, getTransactions	API key
debit, transfer	API key
load, notifyPaymentWebhook	Payments key / HMAC (backend only)
adminStats, adminAccounts	Admin JWT
health	none

API_KEY never credits balance. Top-ups use load or the payments webhook — keep PAYMENTS_API_KEY and PAYMENT_WEBHOOK_SECRET off mobile clients.

Errors

try {
  await client.debit(externalUserId: id, amount: 100);
} on WalletException catch (e) {
  // e.statusCode, e.message, e.isNotFound, ...
}

License

MIT