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

# PaymentCardTransactionRequest

A request for a contactless purchase or refund that includes the purchase amount and currency information.

```
struct PaymentCardTransactionRequest
```

## Overview

Create a `PaymentCardTransactionRequest` to specify the amount of a purchase or refund.
After you create this object, pass it to the
[`readPaymentCard(_:)`](/documentation/ProximityReader/PaymentCardReaderSession/readPaymentCard(_:)-8jol5) or
[`readPaymentCard(_:vasRequest:stopOnVASResult:)`](/documentation/ProximityReader/PaymentCardReaderSession/readPaymentCard(_:vasRequest:stopOnVASResult:))
method of [`PaymentCardReaderSession`](/documentation/ProximityReader/PaymentCardReaderSession) to read the card associated with the transaction.

## Topics

### Creating a transaction request

[`init(amount: Decimal, currencyCode: String, for: PaymentCardTransactionRequest.TransactionType)`](/documentation/ProximityReader/PaymentCardTransactionRequest/init(amount:currencyCode:for:))

Creates a new transaction request for the specified amount in the designated currency.

### Getting the transaction details

[`let amount: Decimal`](/documentation/ProximityReader/PaymentCardTransactionRequest/amount)

The amount of the purchase or refund in the specified currency.

[`let currencyCode: String`](/documentation/ProximityReader/PaymentCardTransactionRequest/currencyCode)

The ISO 4217 code that indicates the currency type.

[`let type: PaymentCardTransactionRequest.TransactionType`](/documentation/ProximityReader/PaymentCardTransactionRequest/type)

The type of transaction, either a purchase or a refund.

[`enum TransactionType`](/documentation/ProximityReader/PaymentCardTransactionRequest/TransactionType)

The type of transaction to perform.

[`var transactionDescription: PaymentCardTransactionRequest.TransactionAmountDescription?`](/documentation/ProximityReader/PaymentCardTransactionRequest/transactionDescription)

An optional description of the current transaction meant to provide more context,
such as a recurring payment being setup or a surcharge applied.

[`enum TransactionAmountDescription`](/documentation/ProximityReader/PaymentCardTransactionRequest/TransactionAmountDescription)

Values that provide additional information about the transaction amount.

### Setting the preferred Application Identifier (AID) list

[`var preferredAIDList: [Data]`](/documentation/ProximityReader/PaymentCardTransactionRequest/preferredAIDList)

The preferred Application Identifier (AID) or Registered Application Provider Identifier (RID).

### Setting the user interface language

[`var userInterfaceLanguage: Locale.Language?`](/documentation/ProximityReader/PaymentCardTransactionRequest/userInterfaceLanguage)

The language the framework uses when localizing the user interface.

### Instance Properties

[`var useISOCurrencySymbol: Bool`](/documentation/ProximityReader/PaymentCardTransactionRequest/useISOCurrencySymbol)

A boolean value that sets the system UI’s currency symbol to ISO 4217 three-letter code.

### Enumerations

[`enum PaymentCycle`](/documentation/ProximityReader/PaymentCardTransactionRequest/PaymentCycle)

Values that specify the frequency of payments

## Relationships

### Conforms To

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

[`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)