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

# PKDisbursementRequest

An object that represents a request to disburse funds from a merchant to an individual.

```
class PKDisbursementRequest
```

## Overview

Use this object to create a disbursement (payment) request from a merchant to a user account — for example, a withdrawal from an online account.

## Topics

### Initializers

[`init(merchantIdentifier:currency:region:supportedNetworks:merchantCapabilities:summaryItems:)`](/documentation/PassKit/PKDisbursementRequest/init(merchantIdentifier:currency:region:supportedNetworks:merchantCapabilities:summaryItems:))

Creates a disbursement request with the parameters you specify.

[`-  initWithMerchantIdentifier:currencyCode:regionCode:supportedNetworks:merchantCapabilities:summaryItems:`](/documentation/PassKit/PKDisbursementRequest/initWithMerchantIdentifier:currencyCode:regionCode:supportedNetworks:merchantCapabilities:summaryItems:)

Creates a new instance of a disbursement request with the merchant identifier, currency and region codes, and other parameters you specify.

### Setting currency and region information

[`currency`](/documentation/PassKit/PKDisbursementRequest/currency)

The currency to use for this disbursement.

[`region`](/documentation/PassKit/PKDisbursementRequest/region)

The geographic region that describes the location for this disbursement.

[`supportedRegions`](/documentation/PassKit/PKDisbursementRequest/supportedRegions-1cl0f)

An array of regions that describe the locations to support.

[`currencyCode`](/documentation/PassKit/PKDisbursementRequest/currencyCode)

The currency code string for this disbursement.

[`regionCode`](/documentation/PassKit/PKDisbursementRequest/regionCode)

The merchant’s country code string.

[`supportedRegions`](/documentation/PassKit/PKDisbursementRequest/supportedRegions-j9ug)

An array of two-letter region codes that describes the regions to support.

### Setting the summary items

[`summaryItems`](/documentation/PassKit/PKDisbursementRequest/summaryItems)

An array of payment summary item objects that the framework presents to people.

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

An object that defines a summary item in a payment request, taxes, discounts, shipping, a grand total, and the like.

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

A summary item that represents a disbursement.

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

A summary item that represents a fee for an instant funds out transfer.

### Setting custom application data

[`applicationData`](/documentation/PassKit/PKDisbursementRequest/applicationData)

Optional merchant-supplied information about the disbursement request.

### Setting the merchant information

[`merchantIdentifier`](/documentation/PassKit/PKDisbursementRequest/merchantIdentifier)

A string that identifies the merchant.

[`merchantCapabilities`](/documentation/PassKit/PKDisbursementRequest/merchantCapabilities)

A value that represents the payment-processing capabilities of the merchant.

[`supportedNetworks`](/documentation/PassKit/PKDisbursementRequest/supportedNetworks)

An array of payment networks the merchant supports.

### Requesting recipient contact fields

[`recipientContact`](/documentation/PassKit/PKDisbursementRequest/recipientContact)

A contact object that describes the recipient.

[`requiredRecipientContactFields`](/documentation/PassKit/PKDisbursementRequest/requiredRecipientContactFields)

An array that indicates which of the recipient’s contact details the merchant requires in order to process a disbursement.

### Handling errors

[`+  disbursementCardUnsupportedError`](/documentation/PassKit/PKDisbursementRequest/disbursementCardUnsupportedError())

Creates an error that indicates that the selected payment pass doesn’t support receiving funds through disbursements.

[`+  disbursementContactInvalidErrorWithContactField:localizedDescription:`](/documentation/PassKit/PKDisbursementRequest/disbursementContactInvalidError(withContactField:localizedDescription:))

Creates a recipient contact error with the supplied field.

## Relationships

### Conforms To

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

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

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

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

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

[`NSObjectProtocol`](/documentation/ObjectiveC/NSObjectProtocol)

### Inherits From

[`NSObject-swift.class`](/documentation/ObjectiveC/NSObject-swift.class)

---

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)