# Apple Pay-Händler-Token So verwenden Sie die Händler-Token von Apple Pay für wiederkehrende, zurückgestellte und automatische Aufladezahlungen. Ein [Apple Pay-Händler-Token (MPAN)](https://developer.apple.com/apple-pay/merchant-tokens/) verknüpft eine Zahlungskarte mit einem Unternehmen und einer Kundin/einem Kunden und ermöglicht es Wallet-Inhaberinnen/-Inhabern, den Zugriff auf eine in ihrer Apple-Wallet gespeicherte Karte zu verwalten. Die aktuellsten Richtlinien von Apple empfehlen Händler-Token anstatt Geräte-Token (DPAN) zu verwenden, da die Händler-Token: - Geräteübergreifende Kontinuität sicherstellen - Wiederkehrende Zahlungen unabhängig vom Gerät ermöglichen - Zahlungsinformationen auf einem neuen Gerät aktiv belassen, auch wenn diese von einem verloren gegangenen oder gestohlenen Gerät entfernt wurden ## Arten von Händler-Token Es gibt drei Möglichkeiten, wie Sie mit Apple Pay eine MPAN anfordern. Jeder Anfragetyp hat unterschiedliche Parameter, die sich darauf auswirken, wie Apple Wallet der Nutzerin/dem Nutzer angezeigt wird. Fast alle Anfragetypen bieten die Möglichkeit, eine `managementURL` anzugeben, die Kundinnen/Kunden zu einer Webseite weiterleitet, auf der sie ihre Zahlungsmethoden verwalten können. Wenn Sie eine MPAN anfordern und der Aussteller die MPAN-Generierung unterstützt, erhalten Sie eine MPAN. Andernfalls erhalten Sie eine DPAN. | Typ der MPAN-Anfrage | Anwendungsszenario | Support | | --------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ | | Wiederkehrend [PKRecurringPaymentRequest](https://developer.apple.com/documentation/passkit/pkrecurringpaymentrequest) | Stellt eine MPAN aus, die für wiederkehrende Zahlungen, wie z. B. Abonnements, genutzt werden kann. | - [Apple Pay für das Web](https://developer.apple.com/documentation/apple_pay_on_the_web) - iOS > v16.0 | | Automatische Aufladungen [PKAutomaticReloadPaymentRequest](https://developer.apple.com/documentation/passkit/pkautomaticreloadpaymentrequest) | Stellt eine MPAN aus, die für Aufstockungen im Geschäft oder Prepaid-Konten genutzt werden kann. Unterstützte Parameter: - `automaticReloadBilling` zeigt Abrechnungsdetails an, wenn Sie Apple Pay anzeigen. | - [Apple Pay für das Web](https://developer.apple.com/documentation/apple_pay_on_the_web) - iOS > v16.0 | | Zurückgestellte Zahlung [PKDeferredPaymentRequest](https://developer.apple.com/documentation/passkit/pkdeferredpaymentrequest) | Stellt eine MPAN zur Verwendung mit Reservierungen aus, z, B. für Hotels. Unterstützte Parameter: - `freeCancellationDate` zeigt die Stornierungsfrist, wenn Sie Apple Pay anzeigen. - `billingAgreement` zeigt die allgemeinen Geschäftsbedingungen an, wenn Sie Apple Pay anzeigen. | - [Apple Pay für das Web](https://developer.apple.com/documentation/apple_pay_on_the_web) - Xcode 14.3 - iOS > v16.4 | ## Apple Pay-Händler-Token hinzufügen Sie können ein [Händler-Token](https://developer.apple.com/apple-pay/merchant-tokens/) hinzufügen, wenn Sie Apple Pay im Express Checkout Element, Payment Element im Browser und Payment Element auf Mobilgeräten anzeigen. Stripe verarbeitet Händler-Token-Anfragen in Integrationen von Stripe Checkout automatisch. #### Express Checkout Element Wenn Sie die [Schaltfläche Zahlungsanfrage](https://docs.stripe.com/stripe-js/elements/payment-request-button.md) für wiederkehrende Zahlungen verwenden, empfehlen wir die [Migration zum Express Checkout Element](https://docs.stripe.com/elements/express-checkout-element/migration.md) für verbesserte Funktionalität und Support für Zahlungsmethoden. 1. Richten Sie ihre [Integration des Express Checkout Element](https://docs.stripe.com/elements/express-checkout-element/accept-a-payment.md) ein. 1. Übergeben Sie das `applePay`-Objekt, das für Ihr MPAN-Anwendungsszenario relevant ist (über das Dropdown-Menü können Sie Codebeispiele verschiedener Anwendungsszenarien anzeigen). 1. Nehmen Sie relevante Parameter für Ihr Anwendungsszenario auf. #### MPAN-Anwendungsszenario - Wiederkehrende Zahlungen ```javascript elements.create('expressCheckout', { applePay: {recurringPaymentRequest: { paymentDescription: "Standard Subscription", regularBilling: { amount: 1000, label: "Standard Package", recurringPaymentStartDate: new Date("2023-03-31"), recurringPaymentEndDate: new Date("2024-03-31"), recurringPaymentIntervalUnit: "year", recurringPaymentIntervalCount: 1, }, billingAgreement: "billing agreement", managementURL: "https://stripe.com", }, }, }); ``` #### MPAN-Anwendungsszenario - Automatisches Neuladen ```javascript elements.create('expressCheckout', { applePay: {automaticReloadPaymentRequest: { paymentDescription: 'My automatic reload payment', managementURL: 'https://example.com/billing', automaticReloadBilling: { amount: 2500, label: 'Automatic Reload', automaticReloadPaymentThresholdAmount: 500 }, } }, // Other options }); ``` #### MPAN-Anwendungsszenario - Zurückgestellte Zahlung ```javascript const stripe = Stripe('pk_test_TYooMQauvdEDq54NiTphI7jx'); elements.create('expressCheckout', { applePay: {deferredPaymentRequest: { paymentDescription: 'My deferred payment', managementURL: 'https://example.com/billing', deferredBilling: { amount: 2500, label: 'Deferred Fee', deferredPaymentDate: new Date('2024-01-05') } } } }); ``` #### Web Payment Element 1. Erstellen Sie eine Instanz des [Payment Element](https://docs.stripe.com/payments/payment-element.md). 1. Übergeben Sie das `applePay`-Objekt, das für Ihr MPAN-Anwendungsszenario relevant ist (über das Dropdown-Menü können Sie Codebeispiele verschiedener Anwendungsszenarien anzeigen). 1. Nehmen Sie relevante Parameter für Ihr Anwendungsszenario auf. #### MPAN-Anwendungsszenario - Wiederkehrende Zahlungen ```javascript const paymentElement = elements.create('payment', { applePay: {recurringPaymentRequest: { paymentDescription: 'My subscription', managementURL: 'https://example.com/billing', regularBilling: { amount: 2500, label: 'Monthly subscription fee', recurringPaymentIntervalUnit: 'month', recurringPaymentIntervalCount: 1, }, }, }, // Other options }); ``` #### MPAN-Anwendungsszenario - Automatisches Neuladen ```javascript const paymentElement = elements.create('payment', { applePay: { automaticReloadPaymentRequest: { paymentDescription: 'My subscription', managementURL: 'https://example.com/billing', regularBilling: { amount: 2500, label: 'Automatic Reload', automaticReloadPaymentThresholdAmount: 500 }, }, }, // Other options }); ``` #### MPAN-Anwendungsszenario - Zurückgestellte Zahlung ```javascript const paymentElement = elements.create('payment', { applePay: { deferredPaymentRequest: { paymentDescription: 'My deferred payment', managementURL: 'https://example.com/billing', deferredBilling: { amount: 2500, label: 'Deferred Fee', deferredPaymentDate: new Date('2024-01-05') }, } }, // Other options }); ``` ## Überwachung der Händler-Token-Authentifizierungsrate Für Sigma-Nutzer/innen enthält die Tabelle der `charges` das Aufzählungsfeld `card_token_type`, um anzugeben, dass für die Zahlung eine `mpan`- oder `dpan`-Karte verwendet wird. Das folgende Sigma-Abfragebeispiel berechnet die MPAN-Authentifizierungsrate: ```sql -- deduplicated MPAN auth rate select 100.0 * count( case when charge_outcome in ('authorized', 'manual_review') then 1 end ) / count(*) as deduplicated_auth_rate_pct, count(*) as n_attempts from authentication_report_attempts a join charges c on c.id = a.charge_id where c.created >= date('2021-01-01') and c.card_tokenization_method = 'apple_pay' -- The new field added to charges table. and c.card_token_type = 'mpan' -- deduplicate multiple manual retries to a single representative charge and is_final_attempt ```