moveme_wallet 0.3.1

SDK Flutter/Dart for MoveMe Digital Wallet (safe client + server payments entry).

moveme_wallet

SDK Flutter/Dart para /api/digital-wallet.

Base URL

Ambiente	URL
Local	http://127.0.0.1:3123
Produção	https://wsup.appmoveme.com

Prefixo: /api/digital-wallet (não incluir no baseUrl).

Install

dependencies:
  moveme_wallet: ^0.3.1

Client (app — X-API-Key)

final wallet = WalletClient(
  options: WalletClientOptions.production(apiKey: apiKey),
  // ou: WalletClientOptions.local(apiKey: apiKey),
);

Método SDK	HTTP
createAccount	POST /api/digital-wallet/accounts
getByExternalUserId	GET /api/digital-wallet/accounts/external/:externalUserId
getBalance	GET /api/digital-wallet/accounts/:walletId/balance
getStatement	GET /api/digital-wallet/accounts/:walletId/transactions
debit	POST /api/digital-wallet/movements (type: debit)
transfer	POST /api/digital-wallet/transfers
listPaymentMethods	GET /api/digital-wallet/payment-methods
createCheckout	POST /api/digital-wallet/checkout
getCheckout	GET /api/digital-wallet/checkout/:paymentId
requestAdvance	POST /api/digital-wallet/advances
getOpenAdvance	GET /api/digital-wallet/advances/open
health	GET /health

Não exporta load / crédito.

Gateway checkout (API v1.2)

final methods = await wallet.listPaymentMethods();
final m = methods.methods.first;
final checkout = await wallet.createCheckout(
  externalUserId: 'moveme:driver_42',
  amount: 2000,
  paymentMethodId: m.paymentMethodId, // UUID — preferido
  // paymentMethod: m.code,            // fallback
);
// 1. abrir checkout.paymentUrl
// 2. guardar checkout.paymentId
// 3. poll getCheckout até status == paid (ou deep link)

Adiantamento

final open = await wallet.getOpenAdvance(externalUserId: uid);
if (open.open) {
  // bloquear presets ≤ open.minTopUpExclusive
}
final result = await wallet.requestAdvance(externalUserId: uid);
// result.credited, result.advance.amountDue → refresh saldo

Web checkout (público — sem API key)

Método SDK	HTTP
payLink	GET /pay?amount=&id=&t=
getPayment	GET /pay/:paymentId
confirmPayment	POST /pay/:paymentId/confirm
getPaymentDone	GET /pay/:paymentId/done
brandLogoUrl / fetchBrandLogo	GET /brand/me-logo.png

final pay = PayWebClient.production();
final url = pay.payLink(
  amount: 2000,
  externalUserId: 'moveme:driver_42',
  tokenOrExp: exp,
);
final session = await pay.getPayment(paymentId);
await pay.confirmPayment(paymentId);

Payments (backend — PAYMENTS_API_KEY)

Método SDK	HTTP
load	POST /api/digital-wallet/loads
sendWebhook	POST /api/digital-wallet/webhooks/payments

Security

• PAYMENTS_API_KEY nunca na app móvel.
• Preferir: mobile → BFF → wallet, ou createCheckout + gateway.

License

MIT