PaymentIntentで支払を実装する場合の選択肢 /「Payment Intents API」使用によるカードの支払確認方法は2種類 / PaymentMethodオブジェクトは歴史的経緯により3種類ある

「決済」及び「開発」関連用語集

カテゴリー: その他エントリー  閲覧数:1704 配信日:2019-04-26 09:21


PaymentIntentで支払を実装する場合の選択肢


A.Customerオブジェクトを作成せずに、支払いを実行
・「1回限りの支払」では推奨される

B.Customerオブジェクトを作成して、PaymentIntentオブジェクトに関連付け、支払いを実行
・ダッシュボードで該当顧客のカード欄に、カード情報は表示されない
・「1回限りの支払」でも使用可
・https://dashboard.stripe.com/test/customers/cus_ExCvsa7yW5YEZ3

C.Customerオブジェクトを作成して、PaymentIntentオブジェクトに関連付け、支払い方法も関連付け、支払いを実行
・PaymentIntentの支払い方法(sourceまたはpayment_method)を関連する顧客に保存する
・ダッシュボードで該当顧客のカード欄に、カード情報が表示される
→ Customerオブジェクトの「sourcesプロパティ」内にある「dataプロパティ」内に、Cardオブジェクトがリスト構造化されて配置される
・「1回限りの支払」でも使用可
・https://dashboard.stripe.com/test/customers/cus_ExBtKF9cWBjqFV

「Payment Intents API」使用によるカードの支払確認方法は2種類


「Payment Intents API」を使用してカードの支払いを受け取る方法は、大きく2種類に分かれる

自動確認フロー
・支払いの収集に必要な操作を自動的に処理する
・Payment Intents API を使用するための最も早い方法だ
・クライアントでの支払いを確認し、支払いが成功したときにWebフックを使用して通知する
・カードの3Dセキュア認証など、一部の支払い方法には非同期フローがあるため、自動確認システムでは、支払い後ロジックを処理するためにWebフックを使用する必要がある

手動確認フロー
・サーバーでの支払いが確認され、支払いが成功した直後にサーバーで支払いを実行できる

比較一覧表
- 自動確認フロー 手動確認フロー
支払いを確認する場所 クライアント サーバ
支払いが成功した後の処理 非同期 同期
Webhook 使用 未使用
この方式が推奨されるケース Webhookに慣れている場合 既存のカードとCharges API システム から移行する場合

PaymentMethodオブジェクトは歴史的経緯により3種類ある


PaymentMethod オブジェクトとして作成した内容
・idプロパティの値が'pm_xxxx'
※下記はただ作成しただけのPaymentMethod オブジェクト。customerに関連付けていないため意味がない
Stripe\PaymentMethod Object
(
   [id] => pm_xxxx
   [object] => payment_method
   [billing_details] => Stripe\StripeObject Object
       (
           [address] => Stripe\StripeObject Object
               (
                   [city] =>
                   [country] =>
                   [line1] =>
                   [line2] =>
                   [postal_code] =>
                   [state] =>
               )

           [email] =>
           [name] =>
           [phone] =>
       )

   [card] => Stripe\StripeObject Object
       (
           [brand] => visa
           [checks] => Stripe\StripeObject Object
               (
                   [address_line1_check] =>
                   [address_postal_code_check] =>
                   [cvc_check] => unchecked
               )

           [country] => JP
           [exp_month] => 4
           [exp_year] => 2020
           [fingerprint] => sNhI3DvKnpKlOtqH
           [funding] => credit
           [generated_from] =>
           [last4] => 0003
           [three_d_secure_usage] => Stripe\StripeObject Object
               (
                   [supported] => 1
               )

           [wallet] =>
       )

   [created] => 1556325087
   [customer] =>
   [livemode] =>
   [metadata] => Stripe\StripeObject Object
       (
       )

   [type] => card
)


PaymentMethod APIを介して取得したカード
・idプロパティの値が'card_xxxx'
Stripe\PaymentMethod Object
(
   [id] => card_xxxx
   [object] => payment_method
   [billing_details] => Stripe\StripeObject Object
       (
           [address] => Stripe\StripeObject Object
               (
                   [city] =>
                   [country] =>
                   [line1] =>
                   [line2] =>
                   [postal_code] =>
                   [state] =>
               )

           [email] =>
           [name] =>
           [phone] =>
       )

   [card] => Stripe\StripeObject Object
       (
           [brand] => mastercard
           [checks] => Stripe\StripeObject Object
               (
                   [address_line1_check] =>
                   [address_postal_code_check] =>
                   [cvc_check] =>
               )

           [country] => US
           [exp_month] => 3
           [exp_year] => 2020
           [fingerprint] => nVED1M937tLxoMHR
           [funding] => credit
           [generated_from] =>
           [last4] => 4444
           [three_d_secure_usage] => Stripe\StripeObject Object
               (
                   [supported] => 1
               )

           [wallet] =>
       )

   [created] => 1552873331
   [customer] => cus_EhrAhwK7W4OB41
   [livemode] =>
   [metadata] => Stripe\StripeObject Object
       (
       )

   [type] => card
)


・idプロパティの値が'src_xxxx'
Stripe\PaymentMethod Object
(
   [id] => src_xxxx
   [object] => payment_method
   [billing_details] => Stripe\StripeObject Object
       (
           [address] => Stripe\StripeObject Object
               (
                   [city] =>
                   [country] =>
                   [line1] =>
                   [line2] =>
                   [postal_code] => 22222
                   [state] =>
               )

           [email] =>
           [name] =>
           [phone] =>
       )

   [card] => Stripe\StripeObject Object
       (
           [brand] => visa
           [checks] => Stripe\StripeObject Object
               (
                   [address_line1_check] =>
                   [address_postal_code_check] => pass
                   [cvc_check] => pass
               )

           [country] => US
           [exp_month] => 4
           [exp_year] => 2024
           [fingerprint] => LMqocVHP8RNDkMLj
           [funding] => credit
           [generated_from] =>
           [last4] => 4242
           [three_d_secure_usage] => Stripe\StripeObject Object
               (
                   [supported] => 1
               )

           [wallet] =>
       )

   [created] => 1552701396
   [customer] => cus_EhrAhwK7W4OB41
   [livemode] =>
   [metadata] => Stripe\StripeObject Object
       (
       )

   [type] => card
)


週間人気ページランキング / 1-9 → 1-15
順位 ページタイトル抜粋 アクセス数
1 Stripe Q16。PaymentIntentの支払いで郵便番号入力を求められる。Radar rules の ZIP code を無効にしているのに | QA(Stripe) 4
1 その他エントリー(Stripe) カテゴリー 4
1 Stripe Q74.「お客様のビジネスの詳細」とは何ですか? | Stripe 4
2 Twitch | ゲーム実況配信サービス(課金販売できるプラットフォーム) 2
2 カテゴリ一覧 2
2 決済用語 2
2 Stripe Q15。PaymentIntent でエラー。カード番号に不備があります。 | QA(Stripe) 2
2 Stripe Payments > PREPARING FOR SCA > Payment Intents | documentation(Stripe) 2
3 EMV / EMV とは? / EMV 仕様 1
3 Gumroadとは?/ 特徴 / Link 1
3 日本で、Connect Standardアカウント を導入している(と思われる)事例 | その他エントリー(Stripe) 1
3 資金決済に関する法律(資金決済法)とは?/(1)前払式支払手段 /(2)資金移動業 1
3 Stripe Q32。Webhook のエンドポイントから適切な値を返さなかったときの停止措置について | QA(Stripe) 1
3 初めに カテゴリー 1
3 Stripe Q20。「webhook」と「synchronous」と「Checkout beta version」について | QA(Stripe) 1
3 新 Stripe 学習の流れを体系化 | その他エントリー(Stripe) 1
3 Stripeアカウントへログインする際、モバイル端末で受信したコード入力を求められる理由は? | その他エントリー(Stripe) 1
3 Stripe Q11。テストAPIで、実際のカード番号を入力したらどうなりますか? | QA(Stripe) 1
3 トークン決済 | セキュリティ 1
3 Stripe Q1。Stripeにおける個人事業主の定義 | QA(Stripe) 1
2025/1/16 1:02 更新
指定期間人気ページランキング / 2020-5-28 → 2025-1-15
順位 ページタイトル抜粋 アクセス数
1 Stripeアカウントへログインする際、モバイル端末で受信したコード入力を求められる理由は? | その他エントリー(Stripe) 2025
2 EMVCo | クレジットカード仕様(仕様) 1344
3 Stripe Q13。決済成功時に、「請求に紐づけられたメールアドレス」に対して、メール送信したいのですが、 | QA(Stripe) 975
4 Twitch | ゲーム実況配信サービス(課金販売できるプラットフォーム) 951
5 Stripe Q16。PaymentIntentの支払いで郵便番号入力を求められる。Radar rules の ZIP code を無効にしているのに | QA(Stripe) 933
6 クレジットカード決済 | 課金 911
7 決済用語 890
8 Stripe Q50。 Connect 「Standardアカウント」で、自身に連結された子アカウントを、ダッシュボードから削除するには? | QA(Stripe) 858
9 EMVレベル1 / EMVレベル2 / EMVCo とは? 830
10 Stripe Q1。Stripeにおける個人事業主の定義 | QA(Stripe) 810
11 pixivFANBOX | クリエイター支援プラットフォーム(課金販売できるプラットフォーム) 804
12 Omise | 「支払」機能を有する決済系サービス(決済サービス) 787
13 Stripe Q31。ダッシュボードでの「支払い作成」の見方について | QA(Stripe) 751
14 YouTube | 動画サービス(課金販売できるプラットフォーム) 719
15 プリペイドカード | カード 653
16 EPUB | ファイルフォーマット(電子書籍) 614
17 Stripe Q74.「お客様のビジネスの詳細」とは何ですか? | Stripe 612
18 Stripeで"No such token: src"と表示されたら、最初にAPIキーを確認する | Stripe エラー(Stripe) 580
19 サブスクリプション | 課金 566
20 Stripe エラー(Stripe) カテゴリー 487
2025/1/16 1:02 更新