payments library
Módulo server-only — loads e webhooks HMAC.
import 'package:moveme_wallet/payments.dart';
Nunca use na app móvel.
Classes
- PaymentsClient
-
Cliente server-only para top-ups (
PAYMENTS_API_KEY/ HMAC). - PaymentsClientOptions
- Opções do PaymentsClient — backend only.
- PaymentWebhookResult
-
Resultado de
POST /webhooks/payments. - PaymentWebhookSignature
- Resultado de signPaymentWebhook.
- PaymentWebhookSigner
- Alias legado.
- WalletLoad
-
Resultado de
POST /loads.
Enums
- WalletErrorCode
- Códigos de erro normalizados.
Functions
-
isAdvanceAlreadyOpen(
Object? err) → bool -
Já existe adiantamento em aberto (
409/ADVANCE_ALREADY_OPEN). -
isAdvanceTopUpTooLow(
Object? err) → bool -
Top-up ≤ dívida do adiantamento (
400/ADVANCE_TOPUP_TOO_LOW). -
isInsufficientFunds(
Object? err) → bool - Saldo insuficiente (HTTP 400 + mensagem).
-
normalizeWebhookSignature(
String signature) → String -
Remove prefixo
sha256=se presente. -
signPaymentWebhook(
{required String secret, required String paymentId, required num amount, required String externalUserId, required String status, int? timestamp}) → PaymentWebhookSignature - HMAC-SHA256 canónico (Node/backend only).
-
walletErrorCodeFromStatus(
int? statusCode) → WalletErrorCode
Typedefs
- LoadResult = WalletLoad
- Alias legado.
- WalletException = WalletApiError
- Alias legado.
- WalletNetworkException = WalletNetworkError
Exceptions / Errors
- WalletApiError
- Erro da API da carteira digital.
- WalletNetworkError
- Rede / timeout.