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.2.5

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
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)

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

Libraries

moveme_wallet
SDK Flutter/Dart — cliente seguro da Carteira Digital MoveMe.
payments
Módulo server-only — loads e webhooks HMAC.