Skip to main content
Apple Pay tokenizes the customer’s underlying card. When you tokenize an Apple Pay payment through Dintero the same tokenization flow that applies to card payments applies here. See Card tokenization overview for background on token types. The apple pay token can be charged using an unscheduled payment, recurrence and CIT payments are not supported.
Tokenization with Apple Pay is supported only via dintero_psp.applepay. If you are using Worldline (bambora.applepay in the API) contact support for help changing your gateway.

Create a token without a payment

To store a token without withdrawing any money, call Payment token session with token_provider.payment_product_type set to dintero_psp.applepay. Request
Response
Redirect the customer to the url to confirm the card with Apple Pay.

Create a token while taking payment

For a session that also has an amount to pay, set generate_payment_token to true under configuration.dintero_psp.applepay. The customer pays with Apple Pay as normal, and a payment token is created from the same authorization. Request
See create session for the full session schema.
Apple Pay does not support the generate_payment_token_config option with a save_card_checkbox, which is available for dintero_psp.creditcard. When generate_payment_token is true for Apple Pay, the card is always tokenized.

Retrieve the payment token

When the payment completes, the token is stored on the transaction. Call get transaction details with the includes query parameter to have the token returned:
The token is then available as card.payment_token in the response. For token status, expiry dates, and how to store the token securely, see Fetch and store payment tokens.

Charge the token as an unscheduled MIT

To charge the stored token without involving the customer, use the unscheduled_purchase operation with Create and pay merchant initiated session. Request
Before you retry a failed merchant initiated transaction, read Tokenization error handling for the retry limits enforced by Visa and Mastercard and for how to prevent duplicate transactions.

Manage stored tokens

Use the card token endpoints to inspect and remove tokens you have stored:

Tokenization life cycle

Apple Pay can provision two different token forms. Currently Dintero only provides DPAN tokens.
  • DPAN (Device Primary Account Number): a device-specific token tied to a particular device. Will expire when the user replaces their device or the card expires.
  • MPAN (Merchant Primary Account Number): a merchant-specific token intended for recurring or card-on-file usage with the same merchant. Continues to work when user replace their device or the physical card expires.

Tokenized cards in the Apple Wallet app

Card tokens

If the customer opens their Wallet app, click on their card and open the “Card details” and select the “Pre-Autorised Payments” section they can see their MPAN payment tokens. Since Dintero only provides DPAN tokens, they are not listed in the end customers app.
Not all issuers support showing and revoking tokens in the “Pre-Autorised Payments” section, it only works in cases where the provisioned card token is an MPAN. Currently Dintero only provides DPAN tokens.

Unscheduled payments

Unscheduled payments where the token is used are not shown to the customer in the “Latest Transactions” history in the Wallet app.
Last modified on November 18, 2026