> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://ixopay.ferndocs.com/developer-hub/documentation/adapters/apple-pay/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://ixopay.ferndocs.com/_mcp/server.

# Apple Pay

This page provides an overview of the payments methods provided by the Apple Pay adapter in the IXOPAY platform. It also includes a full list of all configuration options available to you when integrating Apple Pay within your payments landscape, as well as an overview of the parameters required when submitting a transaction via IXOPAY's API.

Apple Pay is not an adapter itself, but a common type of payment supported by some listed adapters.

## Prerequisites

For processing transactions with Apple Pay tokens, the Gateway has to be configured with your Payment Processing certificate first. Please ask your Gateway administrator to do so.

Instruction on how to acquire this certificate can be found directly in the Apple documentation: [https://developer.apple.com/documentation/apple\_pay\_on\_the\_web/setting\_up\_your\_server](https://developer.apple.com/documentation/apple_pay_on_the_web/setting_up_your_server)

## Transaction Processing

For Apple Pay transactions acquire a Payment Token through your iOS App, or Apple Pay on the Web. (Refer to [https://developer.apple.com/documentation/passkit](https://developer.apple.com/documentation/passkit) & [https://developer.apple.com/documentation/apple\_pay\_on\_the\_web](https://developer.apple.com/documentation/apple_pay_on_the_web)).

The resulting token must be submitted in the `transactionToken` element of the Debit/Preauthorize, prefixed with `applepay:`

Example:

```xml
<transactionToken>
  applepay:{"token":{"paymentData":{"version":"EC_v1","data":"...","signature":"...","publicKeyHash":"...","transactionId":"...."}},"paymentMethod":{"displayName":"Some card","network":"MasterCard","type":"debit"},"transactionIdentifier":"..."}}
</transactionToken>
```