<!--
{
  "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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

[`PaymentCardReaderError.deviceBanned(_:)`](/documentation/ProximityReader/PaymentCardReaderError/deviceBanned(_:))

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

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

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

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

An error that indicates the merchant is invalid or unknown.

[`PaymentCardReaderError.invalidReaderToken(_:)`](/documentation/ProximityReader/PaymentCardReaderError/invalidReaderToken(_:))

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

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

An error that indicates the merchant is blocked.

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

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

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

An authentication error that occurred during connection to the server.

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

A network error.

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

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

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

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

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

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

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

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

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

An error that indicates the reader’s session expired.

[`PaymentCardReaderError.prepareFailed(_:)`](/documentation/ProximityReader/PaymentCardReaderError/prepareFailed(_:))

An error that indicates preparation failed.

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

An error that indicates the card reader is busy.

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

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

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

An error that indicates an internal service is unavailable.

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

An error that indicates the reader’s token expired.

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

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

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

An unexpected error happened, try again.

### Getting the error details

[`errorDescription`](/documentation/ProximityReader/PaymentCardReaderError/errorDescription)

A plain-text description of the error.

[`errorName`](/documentation/ProximityReader/PaymentCardReaderError/errorName)

The name of the 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)