Affirm 支払いの受け付け

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

• 使用できるのは 1 回限りのラインアイテムだけです。Affirm は、継続的なサブスクリプションプランに対応していません。
• すべての価格を国内通貨で示します。

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

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

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

1. affirm を 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', 'affirm'],
      line_items: [{
        price_data: {
          currency: 'usd',
          product_data: {
            name: 'T-shirt',
          },
          # Make sure the total amount fits within Affirm's transaction amount limits
          unit_amount: 5000,
        },
        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: ['CA', '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 の組み込みをテストする際に、支払い方法として Affirm を選択して、支払いボタンをクリックします。

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

ユーザーが認証に失敗するケースをテストするには、テスト API キーを使用してリダイレクトページを表示します。リダイレクトページで、Affirm モーダルウィンドウを閉じ、支払いが失敗したことを確認します。PaymentIntent は requires_action から requires_payment_method に移行します。

Affirm サンドボックスにリダイレクトされると、Affirm によって SSN の末尾 4 桁が求められることがあります。Affirm Sandboxは、'0000' または '5678' の使用を提案します。

テスト環境で PaymentIntent を手動でキャプチャーする場合、未キャプチャーの PaymentIntent は、オーソリの成功後 10 分で自動的に期限切れになります。