<!--
{
  "availability" : [
    "iOS: 15.4.0 -",
    "iPadOS: 15.4.0 -",
    "macCatalyst: 17.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "ProximityReader",
  "identifier" : "/documentation/ProximityReader/PaymentCardReaderError",
  "metadataVersion" : "0.1.0",
  "role" : "Enumeration",
  "symbol" : {
    "kind" : "Enumeration",
    "modules" : [
      "ProximityReader"
    ],
    "preciseIdentifier" : "s:15ProximityReader011PaymentCardB5ErrorO"
  },
  "title" : "PaymentCardReaderError"
}
-->

# PaymentCardReaderError

An error type that indicates problems with the configuration of the reader.

```
enum PaymentCardReaderError
```

## Topics

### Getting the error code

[`case accountAlreadyLinked`](/documentation/ProximityReader/PaymentCardReaderError/accountAlreadyLinked)

An error that indicates the merchant already accepted the Terms and Conditions.

[`case accountDeactivated`](/documentation/ProximityReader/PaymentCardReaderError/accountDeactivated)

An error that indicates the linked Apple Account account has been deactivated by the merchant.

[`case accountLinkingCancelled`](/documentation/ProximityReader/PaymentCardReaderError/accountLinkingCancelled)

An error that indicates the user cancelled the linking or relinking operation.

[`case accountLinkingCheckFailed`](/documentation/ProximityReader/PaymentCardReaderError/accountLinkingCheckFailed)

An error that indicates the system couldn’t check the account status of the merchant.

[`case accountLinkingFailed`](/documentation/ProximityReader/PaymentCardReaderError/accountLinkingFailed)

An error that indicates the system couldn’t link or relink the merchant using the provided Apple Account.

[`case accountLinkingRequiresiCloudSignIn`](/documentation/ProximityReader/PaymentCardReaderError/accountLinkingRequiresiCloudSignIn)

An error that indicates the merchant must be signed into iCloud to accept the Terms and Conditions.

[`case accountNotLinked`](/documentation/ProximityReader/PaymentCardReaderError/accountNotLinked)

An error that indicates the merchant must accept the Terms and Conditions with a valid Apple Account.

[`case backgroundRequestNotAllowed`](/documentation/ProximityReader/PaymentCardReaderError/backgroundRequestNotAllowed)

An error that results from requests to the reader while the host app is in the background state.

[`case deviceBanned(Date?)`](/documentation/ProximityReader/PaymentCardReaderError/deviceBanned(_:))

An error that indicates the device is banned until the specified date.

[`case emptyReaderToken`](/documentation/ProximityReader/PaymentCardReaderError/emptyReaderToken)

An error that indicates the reader token is empty, which is invalid.

[`case invalidMerchant`](/documentation/ProximityReader/PaymentCardReaderError/invalidMerchant)

An error that indicates the merchant is invalid or unknown.

[`case invalidReaderToken(String?)`](/documentation/ProximityReader/PaymentCardReaderError/invalidReaderToken(_:))

An error that indicates an invalid, non-empty reader token.

[`case merchantBlocked`](/documentation/ProximityReader/PaymentCardReaderError/merchantBlocked)

An error that indicates the merchant is blocked.

[`case modelNotSupported`](/documentation/ProximityReader/PaymentCardReaderError/modelNotSupported)

An error that indicates the current device isn’t supported.

[`case networkAuthenticationError`](/documentation/ProximityReader/PaymentCardReaderError/networkAuthenticationError)

An authentication error that occurred during connection to the server.

[`case networkError`](/documentation/ProximityReader/PaymentCardReaderError/networkError)

A network error.

[`case notAllowed`](/documentation/ProximityReader/PaymentCardReaderError/notAllowed)

An error usually caused by an entitlement issue, an invalid application bundle,
a configuration issue, or a token issue.

[`case notReady`](/documentation/ProximityReader/PaymentCardReaderError/notReady)

An error that indicates the reader session isn’t ready.

[`case osVersionNotSupported`](/documentation/ProximityReader/PaymentCardReaderError/osVersionNotSupported)

An error that indicates the current OS version isn’t supported.

[`case passcodeDisabled`](/documentation/ProximityReader/PaymentCardReaderError/passcodeDisabled)

An error that indicates the device doesn’t have an active passcode.

[`case prepareExpired`](/documentation/ProximityReader/PaymentCardReaderError/prepareExpired)

An error that indicates the reader’s session expired.

[`case prepareFailed(String?)`](/documentation/ProximityReader/PaymentCardReaderError/prepareFailed(_:))

An error that indicates preparation failed.

[`case readerBusy`](/documentation/ProximityReader/PaymentCardReaderError/readerBusy)

An error that indicates the card reader is busy.

[`case readerMemoryFull`](/documentation/ProximityReader/PaymentCardReaderError/readerMemoryFull)

An error that indicates the reader’s internal memory is full.

[`case serviceConnectionError`](/documentation/ProximityReader/PaymentCardReaderError/serviceConnectionError)

An error that indicates an internal service is unavailable.

[`case tokenExpired`](/documentation/ProximityReader/PaymentCardReaderError/tokenExpired)

An error that indicates the reader’s token expired.

[`case unsupported`](/documentation/ProximityReader/PaymentCardReaderError/unsupported)

An error that indicates unsupported hardware or a problem with the device.

[`case unknown(code: Int)`](/documentation/ProximityReader/PaymentCardReaderError/unknown(code:))

An unexpected error happened, try again.

### Getting the error details

[`var errorDescription: String`](/documentation/ProximityReader/PaymentCardReaderError/errorDescription)

A plain-text description of the error.

[`var errorName: String`](/documentation/ProximityReader/PaymentCardReaderError/errorName)

The name of the error.

### Enumeration Cases

[`case requestInterrupted`](/documentation/ProximityReader/PaymentCardReaderError/requestInterrupted)

An error that indicates the application went to background before a reader request completed.

[`case storeAndForwardNotAllowed`](/documentation/ProximityReader/PaymentCardReaderError/storeAndForwardNotAllowed)

An error that indicates the framework can’t create a Store and Forward session because:

[`case storeAndForwardSessionExpired`](/documentation/ProximityReader/PaymentCardReaderError/storeAndForwardSessionExpired)

An error that indicates the framework can’t execute more reads using the current Store and
Forward session, because it’s expired.

[`case storeAndForwardSessionInvalidated`](/documentation/ProximityReader/PaymentCardReaderError/storeAndForwardSessionInvalidated)

An error that indicates the framework invalidated the current Store and Forward session,
and it can’t execute additional reads.

[`case storeAndForwardTokenIssuerChanged`](/documentation/ProximityReader/PaymentCardReaderError/storeAndForwardTokenIssuerChanged)

An error that indicates the current Store and Forward mode has payments
from a different token issuer.

## Relationships

### Conforms To

[`SendableMetatype`](/documentation/Swift/SendableMetatype)

[`Sendable`](/documentation/Swift/Sendable)

[`Error`](/documentation/Swift/Error)

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)