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 セッションが次の条件をすべて満たしている必要があります。

使用できるのは 1 回限りのラインアイテムだけです (継続的なサブスクリプションプランには対応していません)。
価格は国内通貨で示す必要があります。
配送先を指定する必要があります。

支払いを受け付ける

注

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

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

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

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

afterpay_clearpay を payment_method_types のリストに追加します。
すべての line_items でお客様の国内通貨を使用していることを確認します。
shipping_address_collection[allowed_countries] にお客様の国を追加して、配送先住所を収集します。Checkout で配送先住所を収集していない場合は、payment_intent_data[shipping] を使用して配送先住所を指定します。

注文を実行する

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.

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

エラーコード

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

エラーコード	推奨アクション
`invalid_amount_too_small`	Enter an amount within Afterpay’s default transactions limits for the country.
`invalid_amount_too_large`	Enter an amount within Afterpay’s default transactions limits for the country.
`payment_intent_invalid_currency`	Enter the appropriate currency. Afterpay only supports domestic transactions.
`missing_required_parameter`	必須のパラメーターの詳細については、エラーメッセージを確認してください。
`nonexistent_country`	配送の詳細と請求の詳細の `country` プロパティーには、有効な ISO の 2 文字の国コードを入力してください。
`payment_intent_redirect_confirmation_without_return_url`	Afterpay で PaymentIntent を確定する際は、`return_url` を指定します。