コンテンツにスキップ
アカウントを作成
または
サインイン
Stripe ドキュメントのロゴ
/
アカウントを作成
サインイン
概要構築済みのシステムをアップグレード
オンライン決済
概要ユースケースを見つけるManaged Payments
決済手段
支払いインターフェイス
決済シナリオ
店頭支払い
決済にとどまらない機能

注

このページはまだ日本語ではご利用いただけません。より多くの言語で文書が閲覧できるように現在取り組んでいます。準備が整い次第、翻訳版を提供いたしますので、もう少しお待ちください。

Afterpay または Clearpay の支払いを受け付ける

アメリカ、カナダ、イギリス、オーストラリア、ニュージーランドで、Afterpay (イギリスでは Clearpay とも呼ばれている) による支払い方法を受け付ける方法をご紹介します。

注意

Stripe は、顧客の通貨、決済手段の制限、その他のパラメーターを評価して、決済手段オプションを自動的に提示します。決済を受け付けるの手順を使用して、Stripe ダッシュボードから決済手段を設定することをお勧めします。

引き続き、Checkout で顧客に提示する決済手段を手動で設定する場合は、このガイドを使用します。それ以外の場合は、ダッシュボードで決済手段を設定できるように、構築済みのシステムを更新してください。

Afterpay は、使用が 1 回限りの即時通知型の決済手段であり、顧客は支払いの認証を求められます。顧客は Afterpay のサイトにリダイレクトされ、そこで分割払いプランの規約に同意します。顧客が規約に同意すると、Afterpay により顧客への資金提供が保証され、お客様の Stripe アカウントに送金されます。顧客は一定の期間で直接 Afterpay に返済します。

注

連携を始める前に、決済手段の設定に移動して、アカウントが Afterpay の対象であることを確認してください。

互換性を判断する

Afterpay 支払いに対応するには、Checkout セッションが次の条件をすべて満たしている必要があります。

  • 使用できるのは単一の項目だけです (継続的なサブスクリプションプランには対応していません)。
  • 価格は国内通貨で示す必要があります。

支払いを受け付ける

注

このガイドは、Checkout の基本的な支払いの受け付けの実装が存在することを前提として作成されています。

このガイドでは、Afterpay を有効にする方法を紹介し、カード支払いを受け付ける場合と、Afterpay を使用する場合の違いも説明します。

支払い方法として Afterpay を有効にする

新しい Checkout セッションを作成する際は、以下を行う必要があります。

  1. afterpay_clearpay を payment_method_types のリストに追加します。
  2. すべての line_items でお客様の国内通貨を使用していることを確認します。
  3. shipping_address_collection[allowed_countries] に国を追加して、配送先住所を収集することをお勧めします。Checkout での配送先住所の収集を望まない場合は、payment_intent_data[shipping] を使用して配送先住所を指定することもできます。これにより、ローン承認率が向上します。
Ruby
Python
PHP
Java
Node
Go
.NET
No results
Stripe::Checkout::Session.create({
      mode: 'payment',
      payment_method_types: ['card'],
      payment_method_types: ['card', 'afterpay_clearpay'],
      line_items: [{
        price_data: {
          currency: 'usd',
          product_data: {
            name: 'T-shirt',
          },
          # Make sure the total amount fits within Afterpay transaction amount limits:
          # https://stripe.com/docs/payments/afterpay-clearpay#collection-schedule
          unit_amount: 2000,
        },
        quantity: 1,
      }],
      shipping_address_collection: {
        # Shipping address is optional but recommended to pass in
        # Specify which shipping countries Checkout should provide as options for shipping locations
        allowed_countries: ['AU', 'CA', 'GB', 'NZ', 'US'],
      },
      # If you already have the shipping address, provide it in payment_intent_data:
      # payment_intent_data: {
      #   shipping: {
      #     name: 'Jenny Rosen',
      #     address: {
      #       line1: '1234 Main Street',
      #       city: 'San Francisco',
      #       state: 'CA',
      #       country: 'US',
      #       postal_code: '94111',
      #     },
      #   },
      # },
      success_url: 'https://example.com/success',
      cancel_url: 'https://example.com/cancel',
    })

注文を実行する

顧客が支払いステータスページに戻ることに依存せずに、Webhook のような方法を使用して注文のフルフィルメントを行います。

支払いのステータスに変化があると、以下のイベントが送信されます。

イベント名説明次のステップ
checkout.session.completed顧客が Checkout フォームを送信して、支払いのオーソリを正常に完了しました。支払いが成功するか、失敗するまで待ちます。
payment_intent.succeeded顧客の支払いが成功しました。PaymentIntent は succeeded に移行します。顧客が購入した商品またはサービスの発送を行います。
payment_intent.payment_failed顧客の支払いが拒否されたか、その他の理由で失敗しました。PaymentIntent のステータスは requires_payment_method に戻ります。顧客にメールで連絡して、新たに注文するように依頼してください。

詳しくは、注文のフルフィルメントの実行をご覧ください。

組み込みをテストする

Checkout の組み込みをテストする際は、支払い方法として Afterpay を選択して、支払いボタンをクリックします。

テスト API キーを使用して Afterpay の組み込みをテストするには、リダイレクトページを表示します。リダイレクトページで支払いを認証することにより、支払い成功のケースをテストできます。PaymentIntent は requires_action から succeeded に変化します。

ユーザが認証に失敗するケースをテストするには、テスト API キーを使用してリダイレクトページを表示します。リダイレクトページでテスト支払い失敗をクリックします。PaymentIntent は、requires_action から requires_payment_methodに変化します。

テスト環境で PaymentIntents を手動でキャプチャする場合、キャプチャされていない PaymentIntent は、認証が成功してから 10 分後に自動的に期限切れになります。

失敗した支払い

Afterpay は、取引を受け付けるか拒否するかを決定する際に複数の要因を考慮します (買い手が Afterpay を使用している期間、顧客が返済する必要のある未払い額、現在の注文の値など)。

Afterpay による支払いは多くの決済手段よりも支払い拒否の確立が高いため、チェックアウトフローには常に card などの他の支払いオプションを提示する必要があります。このような場合、PaymentMethod は解除され、PaymentIntenオブジェクトのステータスは自動的に requires_payment_method に変わります。

Afterpay の PaymentIntent のステータスが requires_action の場合、顧客は Afterpay のサイトにリダイレクトされてから 3 時間以内に支払いを完了する必要があります (拒否された支払いには適用されません)。3 時間以内にアクションが実行されなければ、PaymentMethod の関連付けが解除され、PaymentIntent のステータスは自動的に requires_payment_method に移行します。

このような場合、決済フローに表示される別の支払いオプションで再試行するように顧客に通知します。

エラーコード

一般的なエラーコードと対応する推奨アクションは以下のとおりです。

エラーコード推奨される対応
payment_intent_payment_attempt_failedAfterpay の決済が失敗したことを示す一般的なエラー。これは、拒否エラーコードとして表示されない拒否である可能性もあります。
payment_method_provider_declineAfterpay が顧客の支払いを拒否しました。次のステップとして、顧客から Afterpay に詳細を問い合わせる必要があります。
payment_intent_payment_attempt_expired顧客が Afterpay の決済ページで支払いを完了しておらず、支払いセッションの期限が切れています。Stripe は、最初の決済フローの作成から 3 時間が経過しても正常にオーソリされなかった Payment Intents を自動的に期限切れにします。
payment_method_not_availableAfterpay でサービス関連のエラーが発生したため、リクエストを完了できません。後で再試行してください。
amount_too_smallAfterpay の国別のデフォルトの取引限度額以内の金額を入力してください。
amount_too_largeAfterpay の国別のデフォルトの取引限度額以内の金額を入力してください。

参照情報

このページはお役に立ちましたか。
はいいいえ