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

# PaymentCardReadResult

The result of a payment card read operation.

```
struct PaymentCardReadResult
```

## Overview

The system returns a `PaymentCardReadResult` in response to your requests to
read a person’s payment card. Use this information to facilitate payments with
your payment service provider.

For information about how to read a payment card, see
[`PaymentCardReaderSession`](/documentation/ProximityReader/PaymentCardReaderSession).

## Topics

### Getting the result data

[`let generalCardData: String?`](/documentation/ProximityReader/PaymentCardReadResult/generalCardData)

A Base64-encoded string that contains general cardholder and terminal data in
tag-length-value (TLV) format.

[`let paymentCardData: String?`](/documentation/ProximityReader/PaymentCardReadResult/paymentCardData)

A Base64-encoded string that contains the encrypted payment information
to send to your payment provider.

### Checking the read outcome

[`let outcome: PaymentCardReadResult.ReadOutcome`](/documentation/ProximityReader/PaymentCardReadResult/outcome)

The outcome of the transaction.

[`enum ReadOutcome`](/documentation/ProximityReader/PaymentCardReadResult/ReadOutcome)

Values that describe the outcome of a read request.

### Getting the result ID

[`let id: String`](/documentation/ProximityReader/PaymentCardReadResult/id)

The unique identifier for the transaction.

### Getting the PIN status

[`let isPINFallback: Bool`](/documentation/ProximityReader/PaymentCardReadResult/isPINFallback)

A Boolean value that indicates whether the PIN Fallback occurred.

[`let pinBypassed: Bool`](/documentation/ProximityReader/PaymentCardReadResult/pinBypassed)

A Boolean value that indicates whether the consumer bypassed the PIN entry.

### Getting the kernel type

[`let applicationTypeIdentifier: String?`](/documentation/ProximityReader/PaymentCardReadResult/applicationTypeIdentifier)

A string identifier that represents the payment application type (kernel) used to read the card.

### Instance Properties

[`let cardEffectiveState: PaymentCardReadResult.CardEffectiveState?`](/documentation/ProximityReader/PaymentCardReadResult/cardEffectiveState-swift.property)

The effective state of the card that the system read.

[`let cardExpirationState: PaymentCardReadResult.CardExpirationState?`](/documentation/ProximityReader/PaymentCardReadResult/cardExpirationState-swift.property)

The expiration state of the card that the system read.

### Enumerations

[`enum CardEffectiveState`](/documentation/ProximityReader/PaymentCardReadResult/CardEffectiveState-swift.enum)

Values that describe the effective state of the card that was read.

[`enum CardExpirationState`](/documentation/ProximityReader/PaymentCardReadResult/CardExpirationState-swift.enum)

Values that describe the expiration state of the card that the system read.

## Relationships

### Conforms To

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

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

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

---

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)