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 withtoken_provider.payment_product_type set to dintero_psp.applepay.
Request
url to confirm the card with Apple Pay.
Create a token while taking payment
For a session that also has an amount to pay, setgenerate_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
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 theincludes query parameter to have the token returned:
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 theunscheduled_purchase
operation with Create and pay merchant initiated session.
Request
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.