Enum Ecr17Error 

#[non_exhaustive]
pub enum Ecr17Error {
    FieldOverflow {
        value: String,
        width: usize,
    },
    NegativeAmount,
    InvalidPaymentType {
        value: char,
    },
    VasTooLong,
    TagContentInvalid,
    ContractCodeInvalid,
    Disconnected,
    AckTimeout {
        attempts: u32,
    },
    Nak {
        attempts: u32,
    },
    ResponseTimeout,
    Transport {
        kind: ErrorKind,
        message: String,
    },
}

Errors produced while building or parsing ECR17 messages (and, under the tokio-transport feature, while talking to a terminal).

The type intentionally derives Clone/PartialEq/Eq (ergonomic for callers and tests). To keep those derives as new variants are added, error data is modeled with Clone + Eq types — e.g. transport variants will carry a std::io::ErrorKind plus a message String rather than a non-Clone/non-Eq std::io::Error.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

FieldOverflow

A value is longer than its fixed-width field. ECR17 fields have a fixed length, so an oversized value would shift every following field and corrupt the frame — building it is refused.

Fields

value: String

The offending value.

width: usize

The field width it overflowed.

NegativeAmount

A monetary amount was negative.

InvalidPaymentType

The payment-type digit was not one of '0' (auto), '1' (debit), '2' (credit), '3' (other). Refused so a malformed frame is never sent to a card-charging terminal.

Fields

value: char

The offending character.

VasTooLong

A VAS request payload exceeded the 1024-byte limit.

TagContentInvalid

The additional-data TAG content was empty, longer than 100 chars, or contained the field separator (0x1B), which would prematurely terminate the field.

ContractCodeInvalid

The tokenization contract code was empty, longer than 18 chars, or contained a non-alphanumeric character (it is interpolated into a structured TAG value).

Disconnected

The transport dropped during an exchange. 💰 A financial command is NEVER blindly re-sent after this — recover a lost response via send_last_result (G).

AckTimeout

No physical ACK was received after attempts send attempts.

Fields

attempts: u32

Total send attempts made (initial + retransmissions).

Nak

The terminal NAKed the request after attempts send attempts.

Fields

attempts: u32

Total send attempts made (initial + retransmissions).

ResponseTimeout

No application response arrived before the response timeout (after the ACK).

Transport

A transport-layer I/O error (real TCP transport). Carries the std::io::ErrorKind (Clone + Eq) plus a message rather than the non-Clone std::io::Error.

Fields

kind: ErrorKind

The underlying I/O error kind.

message: String

A human-readable message.

Trait Implementations

impl Clone for Ecr17Error

fn clone(&self) -> Ecr17Error

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Ecr17Error

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

Formats the value using the given formatter.

impl Display for Ecr17Error

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

Formats the value using the given formatter.

impl Eq for Ecr17Error

impl Error for Ecr17Error

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<Error> for Ecr17Error

Available on crate feature tokio-transport only.

fn from(e: Error) -> Self

Converts to this type from the input type.

impl PartialEq for Ecr17Error

fn eq(&self, other: &Ecr17Error) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for Ecr17Error