Struct Ecr17Client 

pub struct Ecr17Client<T: Transport> { /* private fields */ }

High-level ECR17 client over a Transport T.

Implementations

impl<T: Transport> Ecr17Client<T>

pub fn new(transport: T, config: Ecr17Config) -> Self

Creates a client over transport with config. The transport must already target the configured host/port (it is (re)connected on demand).

pub fn configuration(&self) -> &Ecr17Config

The active configuration.

pub fn set_on_progress( &self, cb: impl Fn(ProgressEvent) + Send + Sync + 'static, )

Registers the progress-update listener (SOH frames during a procedure).

pub fn set_on_receipt_line( &self, cb: impl Fn(ReceiptLine) + Send + Sync + 'static, )

Registers the receipt-line listener (S messages when ECR printing is on).

pub fn set_on_connection_state_change( &self, cb: impl Fn(ConnectionState) + Send + Sync + 'static, )

Registers the connection-state listener.

pub fn transport(&self) -> &T

Borrows the underlying session’s transport (read-only).

pub async fn connect(&mut self) -> Result<()>

Opens the connection (emits Connecting → Connected/Disconnected).

pub async fn disconnect(&mut self)

Closes the connection (emits Disconnected).

pub fn is_connected(&self) -> bool

Whether the transport currently believes it is connected.

pub async fn status(&mut self) -> Result<PosStatusResponse>

Status (s).

pub async fn pay(&mut self, request: &PaymentRequest) -> Result<PaymentResult>

Payment (P).

pub async fn pay_extended( &mut self, request: &PaymentRequest, ) -> Result<PaymentResult>

Extended payment (X).

pub async fn reverse( &mut self, request: &ReversalRequest, ) -> Result<ReversalResult>

Reversal (S).

pub async fn pre_auth( &mut self, request: &PreAuthRequest, ) -> Result<PreAuthResult>

Pre-auth (p).

pub async fn incremental_auth( &mut self, request: &IncrementalAuthRequest, ) -> Result<PreAuthResult>

Incremental pre-auth (i).

pub async fn pre_auth_closure( &mut self, request: &PreAuthClosureRequest, ) -> Result<PaymentResult>

Pre-auth closure (c).

pub async fn verify_card( &mut self, request: &CardVerificationRequest, ) -> Result<CardVerificationResult>

Card verification (H).

pub async fn close_session(&mut self) -> Result<CloseSessionResult>

Close session (C).

pub async fn totals(&mut self) -> Result<TotalsResult>

Totals (T).

pub async fn send_last_result(&mut self) -> Result<PaymentResult>

Send last result (G) — recovers a lost financial response without re-charging.

pub async fn enable_ecr_printing(&mut self, enabled: bool) -> Result<()>

Enable/disable ECR printing (E).

pub async fn reprint(&mut self, to_ecr: bool) -> Result<()>

Reprint the last ticket (R).

pub async fn vas(&mut self, xml_request: &str) -> Result<VasResult>

VAS (K).

Reads a single VAS response message (as the reference does). A multi-part response (more_messages set) is not concatenated here — that is a documented limitation to validate against a real terminal before implementing.

Trait Implementations

impl<T: Transport> Debug for Ecr17Client<T>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.