<!--
{
  "availability" : [
    "iOS: 14.0.0 -",
    "iPadOS: 14.0.0 -",
    "macCatalyst: 14.0.0 -",
    "visionOS: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "PassKit",
  "identifier" : "/documentation/PassKit/PKIssuerProvisioningExtensionHandler",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "PassKit (Apple Pay and Wallet)"
    ],
    "preciseIdentifier" : "c:objc(cs)PKIssuerProvisioningExtensionHandler"
  },
  "title" : "PKIssuerProvisioningExtensionHandler"
}
-->

# PKIssuerProvisioningExtensionHandler

An abstract superclass for an app extension to add a payment card to Wallet.

```
class PKIssuerProvisioningExtensionHandler
```

## Overview

The principal class of your app’s extension target must be a subclass of `PKIssuerProvisioningExtensionHandler`.

Your app must be installed and the user open the app at least once for the system to call the extension handler.

> Important:
> Before you can add a payment card provisioning extension you need an entitlement from Apple. For more information on requesting an entitlement, contact apple-pay-inquiries@apple.com.

## Topics

### Returning extension status

[`status(completion:)`](/documentation/PassKit/PKIssuerProvisioningExtensionHandler/status(completion:))

Reports the status of your Wallet extension.

[`PKIssuerProvisioningExtensionStatus`](/documentation/PassKit/PKIssuerProvisioningExtensionStatus)

An object that indicates whether there are any payment cards available to add as Wallet passes.

### Returning available passes

[`passEntries(completion:)`](/documentation/PassKit/PKIssuerProvisioningExtensionHandler/passEntries(completion:))

Reports the list of passes available to add to an iPhone.

[`remotePassEntries(completion:)`](/documentation/PassKit/PKIssuerProvisioningExtensionHandler/remotePassEntries(completion:))

Reports the list of passes available to add to an Apple Watch.

[`PKIssuerProvisioningExtensionPassEntry`](/documentation/PassKit/PKIssuerProvisioningExtensionPassEntry)

An object that represents an item available to add to as a Wallet pass.

[`PKIssuerProvisioningExtensionPaymentPassEntry`](/documentation/PassKit/PKIssuerProvisioningExtensionPaymentPassEntry)

An object that represents a payment card available to add as a payment pass.

### Returning information for adding a pass

[`generateAddPaymentPassRequestForPassEntryWithIdentifier(_:configuration:certificateChain:nonce:nonceSignature:completionHandler:)`](/documentation/PassKit/PKIssuerProvisioningExtensionHandler/generateAddPaymentPassRequestForPassEntryWithIdentifier(_:configuration:certificateChain:nonce:nonceSignature:completionHandler:))

Creates an object with the data the system needs to add a card to Apple Pay.


---

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)