moveme_wallet 0.2.4

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

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

final methods = await wallet.listPaymentMethods();
final checkout = await wallet.createCheckout(
  externalUserId: 'moveme:driver_42',
  amount: 2000,
  paymentMethod: 'multicaixa_express',
);
// abrir checkout.paymentUrl

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