Apple Pay マーチャントトークン

Apple Pay マーチャントトークン (MPAN)は、パーチェシングカード、ビジネス、顧客を結び付け、ウォレットの利用者が Apple Wallet に保存されたカードへのアクセスを管理できるようになります。Apple Pay の最新のガイドラインでは、以下のような理由から、デバイストークン (DPAN) よりもマーチャントトークンが推奨されています。

• 複数のデバイスで情報を継続できる
• デバイスに関係なく継続支払いが可能
• 支払い情報が紛失または盗難されたデバイスから削除された場合でも、新しいデバイスでその情報を有効に維持できる
• ライフサイクル管理機能にも導入されており、トークンへの変更を監視したり、トークンが取り消されているかを確認する

マーチャントトークンのタイプ

Apple Pay を使用して、3 つの方法で MPAN をリクエストできます。リクエストの各タイプには、Apple Wallet がユーザーにどのように表示されるかに影響を与えるさまざまなパラメーターがあります。ほぼすべてのリクエストタイプで、managementURL を供給するオプションが提供されており、支払い方法を管理するためのウェブページに顧客を転送します。MPAN をリクエストし、カード発行会社が MPAN 生成をサポートしている場合は、MPAN を受け取ります。それ以外の場合は、DPAN を受け取ります。

Apple Pay マーチャントトークンを追加する

Express Checkout Element、ウェブ Payment Element、モバイル Payment Element で Apple Pay を提示する際にマーチャントトークンを追加できます。Stripe は、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);
});

マーチャントトークンのオーソリ率の監視

Sigma ユーザーの場合は、charges テーブルに含まれている card_token_type 列挙フィールドにより、支払いで mpan カードまたは dpan カードが使用されていることが示されます。次の Sigma クエリの例では、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