<!--
{
  "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:currencyCode:for:)`](/documentation/ProximityReader/PaymentCardTransactionRequest/init(amount:currencyCode:for:))

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

### Getting the transaction details

[`amount`](/documentation/ProximityReader/PaymentCardTransactionRequest/amount)

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

[`currencyCode`](/documentation/ProximityReader/PaymentCardTransactionRequest/currencyCode)

The ISO 4217 code that indicates the currency type.

[`type`](/documentation/ProximityReader/PaymentCardTransactionRequest/type)

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

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

The type of transaction to perform.

[`transactionDescription`](/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.

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

Values that provide additional information about the transaction amount.

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

[`preferredAIDList`](/documentation/ProximityReader/PaymentCardTransactionRequest/preferredAIDList)

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

### Setting the user interface language

[`userInterfaceLanguage`](/documentation/ProximityReader/PaymentCardTransactionRequest/userInterfaceLanguage)

The language the framework uses when localizing the user interface.


---

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)