NMR Dispatch ExpansionMarket

NMR Dispatch – Expansion Market Adapter 1.1.6 NMR Dispatch – Expansion Market Adapter is the optional banking integration module for NMR Dispatch & Jobs Framework. It connects the framework’s server-authoritative payment system to DayZ Expansion ATM accounts, allowing configured dispatch services to reserve money, process verified caller debits, issue worker payouts and handle eligible refunds through Expansion Banking. This adapter is not a standalone mod. The core NMR Dispatch & Jobs Framework and all required DayZ Expansion dependencies must be installed and loaded. Features Expansion ATM account integration Server-authoritative caller debits Worker payouts after verified job completion Configurable service prices Configurable payment splits Eligible cancellation refunds Eligible failure refunds Persistent transaction intents Stable transaction identifiers Ambiguous payment recovery Transaction quarantine protection Expansion maximum-deposit validation Restart and disconnect recovery support No hardcoded physical-currency classnames Server-side payment validation and audit logging How It Works The adapter acts as a payment provider for the main NMR Dispatch framework. When a configured paid service is requested, the framework sends the payment request to this adapter. The adapter then communicates with Expansion Banking to perform the required server-side operation. Depending on the configured workflow, the adapter may: Verify that the caller has a valid Expansion ATM account Verify that the caller has sufficient funds Reserve or debit the configured service amount Store a persistent transaction intent Pay an eligible worker after verified job completion Split the payment between eligible workers Return an eligible refund after cancellation or failure Prevent duplicate payment processing Quarantine transactions with an uncertain or ambiguous result Respect the configured Expansion maximum account balance The client cannot independently create a payment, issue a payout, grant a refund or mark a transaction as completed. All important payment decisions are validated by the server. Requirements NMR Dispatch & Jobs Framework Community Framework — CF DayZ Expansion Core DayZ Expansion Navigation DayZ Expansion Market Expansion ATM system enabled Both the server and clients must load this adapter. Do not install or load this adapter without the core NMR Dispatch & Jobs Framework. Load Order Recommended load order: @CF; @DayZ-Expansion-Licensed; @DayZ-Expansion-Bundle; @NMR_Dispatch; @NMR_Dispatch_ExpansionMarket The adapter must always be loaded after the core NMR Dispatch mod. The exact server startup line may contain additional mods, but the dependency order shown above must be preserved. Configuration In the NMR Dispatch Global configuration, set: "PaymentProvider": "EXPANSION_BANKING" NMR Dispatch configuration files are stored under: <profiles>/NMR_Dispatch/Config/ The Expansion ATM system must also be enabled and correctly configured in the server’s DayZ Expansion Market settings. Configuration changes are loaded during server startup and are not hot-reloaded unless explicitly supported by a future version. This adapter uses numeric Expansion ATM account balances. Physical banknote classnames and denomination values are configured separately in the core framework and are not required when the active payment provider is Expansion Banking. Important Testing Notice Do not enable a new banking configuration directly on a live production economy. Test the complete payment lifecycle on a staging server using controlled test accounts.