Source から Klarna を移行する

Klarna では、Payment Methods API と Payment Intents API を使用する新しい決済プロセスが開始されます。このガイドでは、Stripe Checkout を使用したローコードオプションなど、Sources API による移行の推奨手段について概説します。

PaymentIntents で Klarna の支払いを開始する

PaymentIntents で Klarna の支払いを完了する

重要な相違点

• Klarna 製品の選択: 構築済みの Stripe システムで Klarna 製品の種類を指定する必要はありません。代わりに、顧客が Klarna のリダイレクトページで製品を選択します。決済サイトに、対応可能な Klarna 支払いオプションごとに個別のボタンを追加しないでください。Klarna ボタンを 1 つだけ追加してください。
• Klarna SDK のインライン表示はサポート対象外: 顧客は、支払いを承認するために、支払いページから Klarna サイトにリダイレクトしなければならなくなりました。このため、Klarna SDK を読み込んだり、インラインコンポーネントをレンダリングする必要はありません。
• 支払いの確認はすべての市場で同期的に行われる: これまでは、支払いが成功したかどうかの確認は、非同期で行われることがありました。顧客の承認後、直ちに支払いが成功したかどうかを検出できるようになりました。

決済フローを移行する

Klarna の導入をウェブ決済に移行するには、PaymentIntents API を使用できるようにサーバーとフロントエンドを更新する必要があります。典型的な実装オプションは次の 3 つです。

• 決済フローの Stripe Checkout にリダイレクトする。
• 自社の決済ページで Stripe の Payment Element を使用する。
• 自社のフォームを作成し、Stripe JS SDK を使用して支払いを完了する。

Stripe Checkout または Payment Element を使用すると、コードを変更せずに Stripe ダッシュボードからほとんどの決済方法を追加したり管理したりできます。

以下は、以前の実装ステップと新しい実装ステップを大まかに比較したものです。

オプション 1： Checkout セッションを使用する

Stripe Checkout は、ローコードでホストされた決済ソリューションで、Klarna 決済だけでなく、Stripe がサポートするさまざまな支払い方法を受け付けることができます。現在、自社サイトで決済ページをホストしていて、それに代えて Stripe Checkout を使用する場合は、次を実行してください。

1. Klarna がダッシュボードで有効になっていることを確認します。
2. ご使用のサーバーで Checkout セッションを作成します。payment_method_types の 1 つとして klarna を明示的に設定するか、動的な支払い方法を使用できます。
3. 物品を販売する場合は、配送先住所の収集を有効にするか、shipping_details ハッシュに配送先住所を含めます。
4. 購入者の支払い準備ができたら、セッション URL にリダイレクトします。

オプション 2： Payment Element を使用する

Stripe Payment Element は、Klarna やその他の支払い方法をサポートする、支払いページ用の単一の埋め込み UI コンポーネントです。これは Stripe Checkout の機能を数多く提供しますが、自社の支払いページに表示できます。Payment Element を使用するには、次を実行してください。

1. Klarna がダッシュボードで有効になっていることを確認します。
2. お使いのサーバーで PaymentIntent を作成します。

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "automatic_payment_methods[enabled]"=true \
  -d amount=1099 \
  -d currency=eur

Klarna を payment_method_types の 1 つとして設定して明示的に有効にすることができます。

1. PaymentIntent の client secret をフロントエンドに渡し、Stripe Elements UI ライブラリを初期化します。
2. Payment Element を作成し、ページに埋め込みます。この Element は、顧客が選択した支払い方法に必要な追加フィールドを自動的に収集します。
3. ユーザーが支払いを送信するときに、Payment Element で confirmPayment を呼び出します。 必ず return_url を渡してください。

オプション 3： カスタムフォームを作成する

Stripe JS SDK を使用して、自社のフォームコンポーネントを構築し、Klarna の支払いを完了することができます。完全統合型のソリューションについてご確認ください。この方法で実装するには、次を実行します。

1. Klarna がダッシュボードで有効になっていることを確認します。
2. サーバーで PaymentIntent を作成します。

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "automatic_payment_methods[enabled]"=true \
  -d amount=1099 \
  -d currency=eur

ダッシュボードで支払い方法を管理したくない場合は、Klarna を payment_method_types の 1 つとして設定して明示的に有効にすることができます。

1. フォームを使用して、顧客のメールアドレスと請求先の国を収集します。
2. 顧客が支払いを承認する準備ができたら、支払いページで Stripe.JS を初期化し、confirmKlarnaPayment を呼び出します。呼び出す際は、PaymentIntent の client secret を指定してください。billing_details[email] と billing_details[address][country] のフィールドにメールアドレスと請求先の国が存在することを確認してください。

フィールドマッピングリファレンス

Payment Element または自社のフォームを使用する場合は、以前に Source にあったフィールドを PaymentIntent にマッピングしなおす必要があります。以下の表は、以前のフィールドと新しいフィールドのマッピングです。物品を販売する場合は、配送先情報を渡すことをお勧めします。その他のフィールドはすべて任意で、Klarna がそのページで必要な追加情報を収集します。

購入後

支払いが完了した後、ご利用の実装ポイントに対して次の変更が必要です。

支払いステータスの確認

以前は、実装で API コールのたびに Source と Charge の両方のステータスを確認する必要がありましたが、2 つのステータスをチェックする必要はもうありません。フロントエンドでの確定後に、PaymentIntent または Checkout セッションのステータスを確認するだけで済みます。

PaymentIntent のステータスは、必ずサーバーで取得するか、サーバーで Webhook をリッスンして確認してください。PaymentIntent を確定する際に指定される return_url にユーザーが戻ることだけに依存しないでください。詳細については、こちらをご覧ください。

返金

PaymentIntent が作成した Charge を使用して、引き続き Refunds API を呼び出すことができます。Charge の ID は latest_charge パラメーターで確認できます。または、Refunds API に Charge の代わりに PaymentIntent ID を指定することもできます。

エラー処理

これまでは、Source が作成されたときにエラーを処理する必要がありました。PaymentIntents では、Source でエラーを確認する必要はなく、代わりにPaymentIntent の作成時と顧客が支払いを承認した後に PaymentIntent のエラーを確認する必要があります。PaymentIntent のエラーのほとんどは、無効なリクエストで返されたタイプフィールドに関するものです。

Webhook

これまで Source イベントをリッスンしていた場合は、新しいイベントタイプをリッスンするように実装の更新が必要になる場合があります。 以下は、リッスンする新しいイベントタイプのリファレンスです。