Stripeのオンライン決済を実装する時はChargesよりPayment Intentsを使おう #Stripe

まずStripeのオンライン決済を実装するには3通りの方法があります。

• Stripe Checkout: Stripeが提供する支払いページにリダイレクトして決済する
• Charges API: Charges APIを呼んで自前の支払いフォームで決済する
• Payment Intents API: Payment Intents APIを呼んで自前の支払いフォームで決済する

Charges と Payment Intents 、どちらを使っても自前の支払いフォームでの支払いフローを構築できます。
しかし、Chargesの方は今後は拡張せずPayment Intentsの製品開発に集中することがこちらのページで説明されています。
なのでできればPayment Intentsの方を使いましょう。

ChargesからPayment Intentsへの移行

Payment Intentsへ移行するには、クライアント側とサーバー側両方変更する必要があります。

ざっくり移行手順

1. APIバージョンとライブラリのバージョンを更新する
2. アプリ内で使っているChargesのプロパティを置き換える
   • APIを変更する前に読み取るプロパティを置き換えることで読み取り後の処理が保証されます。
3. (クライアント側)ソースをPayment Intentsへ移行
4. (サーバー側)カード登録フローを統合
5. (サーバー側)決済フローを統合
6. 移行後のフローでテスト

アプリ内で使っているChargesのプロパティを置き換える

段階的に移行するためにChargeオブジェクトにpayment_method_detailsとbilling_detailsが追加されています。
charge.source→charge.payment_method_details, charge.billing_detailsに置き換えましょう。

よく使われているプロパティはこちらです。

カードを登録して支払うフロー

カード情報の送信(クライアント側)

旧APIのcreateToken とcreateSourceをconfirmCardSetupに置き換えます。

stripe.confirmCardSetup(
  clientSecret,
  {
    payment_method: {
      card: cardElement,
      billing_details: {name: cardholderName.value}
    }
  }
).then(function(result) {
  if (result.error) {
    // Display error.message in your UI.
  } else {
    // The SetupIntent was successful!
  }
});

成功するとカード情報をID化したPaymentMethodが返却されるので、それをサーバーに送信します。

カードを登録(サーバー側)

クライアント側で作成したPaymentMethodをカスタマーに追加します。

既存カスタマーの場合

const customer = await stripe.paymentMethods.attach(
  'pm_1FWS6ZClCIKljWvsVCvkdyWg',
  {customer: 'cus_HgIgWLxUAsvn0A'},
);

新規カスタマーの場合

カスタマー登録はCharges APIの時と変わりありません。

const customer = await stripe.customers.create({
  email: '[email protected]',
  payment_method: 'pm_1FWS6ZClCIKljWvsVCvkdyWg',
  invoice_settings: {
    default_payment_method: 'pm_1FWS6ZClCIKljWvsVCvkdyWg', // デフォルトの支払いに設定
  },
});

確認

const paymentMethods = await stripe.paymentMethods.list(
  { customer: 'cus_HgIgWLxUAsvn0A', type: 'card' }
);

決済処理

customerを指定してpaymentIntentを作成します。confirmはデフォルトで分離されているので省略したい場合はfalseを指定してください。

const paymentIntent = await stripe.paymentIntents.create({
        amount: 550,
        currency: 'JPY',
        customer:  'cus_HgIgWLxUAsvn0A',
        confirm: true
})

上で作成されたpaymentIntentを確定

const paymentIntent = await stripe.paymentIntents.capture('pi_1EUnBFF5IfL0eXz9XzeK6PqQ');

1回限りの決済フロー

アプリケーションに会員登録しないまま決済をする場合、もちろんStripe側にもカスタマー登録はされていないのでフローが変わってきます。

決済情報を作成(サーバー側)

サーバー側で決済情報を作成します。

const paymentIntent = await stripe.paymentIntents.create({
  amount: 1099,
  currency: 'jpy',
});

カード情報(クライアント側)

confirmCardPaymentを使ってstripeに直接カード情報を送ります。

stripe.confirmCardPayment(
  'pi_1EUnBFF5IfL0eXz9XzeK6PqQ',
  {
    payment_method: {card: cardElement}
  }
).then(function(result) {
  if (result.error) {
    // Display error.message in your UI.
  } else {
    // The payment has succeeded
    // Display a success message
  }
});

webhooksで決済の結果を取得(サーバー側)

confirmCardPaymentで直接Stripeでの決済を作成するので加盟店サーバーの方でwebhookを受け取って決済結果を取得します。

app.use(require('body-parser').text({type: '*/*'}));

const endpointSecret = 'whsec_...';

app.post('/webhook', function(request, response) {
  const sig = request.headers['stripe-signature'];
  const body = request.body;

  let event = null;

  try {
    event = stripe.webhooks.constructEvent(request.body, sig, endpointSecret);
  } catch (err) {
    // invalid signature
    response.status(400).end();
    return;
  }

  let intent = null;
  switch (event['type']) {
    case 'payment_intent.succeeded':
      intent = event.data.object;
      console.log("Succeeded:", intent.id);
      break;
    case 'payment_intent.payment_failed':
      intent = event.data.object;
      const message = intent.last_payment_error && intent.last_payment_error.message;
      console.log('Failed:', intent.id, message);
      break;
  }

  response.sendStatus(200);
});