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 ダッシュボードからほとんどの決済方法を追加したり管理したりできます。

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

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

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

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

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 イベントをリッスンしていた場合は、新しいイベントタイプをリッスンするように実装の更新が必要になる場合があります。 以下は、リッスンする新しいイベントタイプのリファレンスです。