コンテンツにスキップ
アカウント作成/サインイン
Stripe ドキュメントのロゴ
/
アカウントを作成サインイン
概要構築済みのシステムをアップグレード
オンライン決済
概要ユースケースを見つけるManaged Payments を使用する
対面決済
決済手段
決済シナリオ
決済以外の機能

メモ

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

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

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

注意

Stripe は、通貨、支払い方法の制限、その他のパラメーターを評価することで、適切な支払い方法を顧客に自動的に提示できます。

  • 決済の受け付けガイドに従って、動的な決済手段を使用するチェックアウトの導入を構築します。
  • 動的な決済手段を使用しない場合は、チェックアウトの導入で、決済方法を手動で設定するために以下のステップに従ってください。

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

メモ

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

互換性を判断する

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

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

支払いを受け付ける

メモ

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

このガイドでは、Afterpay を有効にする方法について手順を追って説明し、動的決済手段を使用して決済を受け付ける場合と決済手段を手動で設定する場合の違いを示します。

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

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

  1. afterpay_clearpay を payment_method_types のリストに追加します。
  2. すべての line_items で国内通貨を使用し、合計金額が Afterpay の取引金額制限を超えないようにしてください。
  3. オプションとして、shipping_address_collection[allowed_countries] を使用して、Checkout で配送先として指定できる国を指定します。
Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price_data][currency]"=usd \
  -d "line_items[0][price_data][product_data][name]"=T-shirt \
  -d "line_items[0][price_data][unit_amount]"=2000 \
  -d "line_items[0][quantity]"=1 \
  -d mode=payment \
  -d "payment_method_types[0]"=card \
  -d "payment_method_types[1]"=afterpay_clearpay \
  -d "shipping_address_collection[allowed_countries][0]"=AU \
  -d "shipping_address_collection[allowed_countries][1]"=CA \
  -d "shipping_address_collection[allowed_countries][2]"=GB \
  -d "shipping_address_collection[allowed_countries][3]"=NZ \
  -d "shipping_address_collection[allowed_countries][4]"=US \
  --data-urlencode success_url="https://example.com/success"

Checkout で配送先住所を収集しない場合は、payment_intent_data[shipping] を使用して配送先住所を指定することもできます。そうすることで、ローンの承認率が向上します。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price_data][currency]"=usd \
  -d "line_items[0][price_data][product_data][name]"=T-shirt \
  -d "line_items[0][price_data][unit_amount]"=2000 \
  -d "line_items[0][quantity]"=1 \
  -d mode=payment \
  -d "payment_intent_data[shipping][name]"="Jenny Rosen" \
  -d "payment_intent_data[shipping][address][line1]"="1234 Main Street" \
  -d "payment_intent_data[shipping][address][city]"="San Francisco" \
  -d "payment_intent_data[shipping][address][state]"=CA \
  -d "payment_intent_data[shipping][address][country]"=US \
  -d "payment_intent_data[shipping][address][postal_code]"=94111 \
  -d "payment_method_types[0]"=card \
  -d "payment_method_types[1]"=afterpay_clearpay \
  --data-urlencode success_url="https://example.com/success"

注文を実行する

顧客が支払いステータスページに戻ることに依存せずに、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 では、決済が正常に行われなかった PaymentIntent は、最初のチェックアウト作成から 3 時間後に自動的に有効期限切れとなります。
payment_method_not_availableAfterpay でサービス関連のエラーが発生したため、リクエストを完了できません。後で再試行してください。
amount_too_smallAfterpay の国別のデフォルトの取引限度額以内の金額を入力してください。
amount_too_largeAfterpay の国別のデフォルトの取引限度額以内の金額を入力してください。

参照情報