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

注

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

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

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

ページをコピー

注意

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

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

Afterpay is a single use, immediate notification payment method that requires customers to authenticate their payment. Customers are redirected to the Afterpay site, where they agree to the terms of an installment plan. When the customer accepts the terms, Afterpay guarantees that the funds are available to the customer and transfers the funds to your Stripe account. The customer repays Afterpay directly over time.

注

Before you start the integration, make sure your account is eligible for Afterpay by navigating to your Payment methods settings.

互換性を判断する

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

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

支払いを受け付ける

注

This guide builds on the foundational accept a payment Checkout integration.

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

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

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

  1. afterpay_clearpay を payment_method_types のリストに追加します。
  2. すべての line_items でお客様の国内通貨を使用していることを確認します。
  3. shipping_address_collection[allowed_countries] に国を追加して、配送先住所を収集することをお勧めします。Checkout での配送先住所の収集を望まない場合は、payment_intent_data[shipping] を使用して配送先住所を指定することもできます。これにより、ローン承認率が向上します。
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',
    })

注文を実行する

Use a method such as webhooks to handle order fulfillment, instead of relying on your customer to return to the payment status page.

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

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

Learn more about fulfilling orders.

組み込みをテストする

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

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

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

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

失敗した支払い

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

You should always present additional payment options such as card in your checkout flow, as Afterpay payments have a higher rate of decline than many payment methods. In these cases, the PaymentMethod is detached and the PaymentIntent object’s status automatically transitions to requires_payment_method.

For an Afterpay PaymentIntent with a status of requires_action, customers need to complete the payment within 3 hours after you redirect them to the Afterpay site (this doesn’t apply to declined payments). If they take no action within 3 hours, the PaymentMethod detaches and the object status for the PaymentIntent automatically transitions to 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_smallEnter an amount within Afterpay’s default transactions limits for the country.
amount_too_largeEnter an amount within Afterpay’s default transactions limits for the country.

参照情報

このページはお役に立ちましたか。
はいいいえ
お困りのことがございましたら 、サポートにお問い合わせください。
早期アクセスプログラムにご参加ください。
変更ログをご覧ください。
ご不明な点がございましたら、お問い合わせください。
LLM ですか？llms.txt を読んでください。
Powered by Markdoc