TransactionCoordinatorConfig class

Configuration the POS supplies to a TransactionCoordinator.

Default is fully payloadOnly. A bare TransactionCoordinatorConfig() constructs an instance whose gatewayConfig.mode is GatewayMode.payloadOnly, meaning the coordinator will never instantiate a gateway client and never make any outbound network call. POS apps that want the SDK to forward the encrypted payload must explicitly opt in by passing a GatewayConfig with mode = gatewayHandoff AND a transport / clientFactory pair.

No credentials in this object. Credentials flow through GatewayConfig.authTokenProvider; they are never stored on the coordinator config.

No defaults for transport / clientFactory when handoff is enabled. The coordinator will throw a structured notConfigured error if the POS asks for gatewayHandoff mode without supplying a transport.

Constructors

TransactionCoordinatorConfig({GatewayConfig gatewayConfig = const GatewayConfig(), GatewayTransport? transport, GatewayClientFactory clientFactory = const DefaultGatewayClientFactory(), Duration runTimeout = const Duration(seconds: 120)})
const

Properties

clientFactory → GatewayClientFactory
Factory that builds the GatewayClient used to perform handoffs. Defaults to DefaultGatewayClientFactory - POS apps that want a custom client (e.g. their own URL path or signing logic) supply their own factory.
final
gatewayConfig → GatewayConfig
Gateway-handoff layer configuration. Defaults to payloadOnly.
final
hashCode → int
The hash code for this object.
no setterinherited
runTimeout → Duration
End-to-end timeout for one runTransaction(...) call, measured from method entry to terminal outcome. Does NOT include the time the POS spends rendering UI between coordinator outcome and the next user action.
final
runtimeType → Type
A representation of the runtime type of the object.
no setterinherited
transport → GatewayTransport?
Provider-neutral HTTP transport the gateway client uses. Required when gatewayConfig.mode is GatewayMode.gatewayHandoff; ignored otherwise. The coordinator passes this to clientFactory.create.
final

Methods

noSuchMethod(Invocation invocation) → dynamic
Invoked when a nonexistent method or property is accessed.
inherited
toString() → String
A string representation of this object.
inherited

Operators

operator ==(Object other) → bool
The equality operator.
inherited