Tokens de marchand Apple Pay

Le token de marchand Apple Pay (MPAN) sert à relier une carte de paiement, une entreprise et un client, et permet au titulaire d’un portefeuille Apple Wallet de gérer l’accès à une carte qui y est enregistrée. Plutôt que de choisir des tokens d’appareils (DPAN), les dernières instructions d’Apple Pay recommandent de choisir des tokens de marchand, car :

• Ils assurent la continuité sur plusieurs appareils
• Ils permettent des paiements récurrents sans dépendre d’un appareil
• Ils permettent de conserver les informations de paiement sur un nouvel appareil même après qu’elles ont été supprimées d’un appareil perdu ou volé
• Ils incluent des fonctionnalités de gestion du cycle de vie permettant de suivre les modifications apportées à un jeton ou de vérifier si un jeton a été révoqué

Types de tokens de marchand

Il existe trois manières d’utiliser Apple Pay pour demander un MPAN. Chaque type de requête présente différents paramètres qui affectent la manière dont Apple Wallet est présenté à l’utilisateur. Presque tous les types de requêtes permettent de fournir une managementURL, qui redirige les clients vers une page Web où ils peuvent gérer leurs moyens de paiement. Si vous demandez un MPAN et que l’émetteur prend en charge la génération de MPAN, vous recevez un MPAN. Dans le cas contraire, vous recevez un DPAN.

Ajouter des tokens de marchand Apple Pay

Vous pouvez ajouter un token de marchand lorsque vous présentez Apple Pay dans l’Express Checkout Element, dans le Payment Element sur le Web et dans le Payment Element sur mobile. Stripe gère automatiquement les demandes de tokens de marchand dans les intégrations Stripe Checkout.

expressCheckoutElement.on("click", (e) => {
  const options = {
    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",
      },
    },
  };
  e.resolve(options);
});

Surveillance du taux d’autorisation des tokens de marchand

Pour les utilisateurs de Sigma, la table charges contient un champ d’énumération card_token_type pour indiquer que le paiement utilise une carte mpan ou dpan. L’exemple de requête Sigma suivant calcule le taux d’autorisation MPAN :

-- 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