カード支払いを回収する

支払いを回収する最初のステップは、支払いフローを開始することです。顧客がチェックアウトを開始するとき、アプリケーションは PaymentIntent オブジェクトを作成する必要があります。これは、Stripe での新しい支払いセッションを表します。

テスト金額を使用して、さまざまな結果を生成してみてください。00 で終わる金額では、支払いが承認されます。

次の例は、サーバで PaymentIntent を作成する方法を示しています。

curl https://api.stripe.com/v1/payment_intents \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "amount"=1000 \
  -d "currency"="usd" \
  -d "payment_method_types[]"="card_present" \
  -d "capture_method"="manual"

Terminal の支払いでは、payment_method_types パラメータに card_present が含まれている必要があります。

以下のように決済フローを制御できます。

• card_present 支払いの支払いフローを完全に制御するには、capture_method を manual に設定します。これにより、支払いを確定する前に照合ステップを追加できます。
• 1 ステップで支払いのオーソリとキャプチャーを行うには、capture_method を automatic に設定します。

カナダで Interac の支払いを受け入れるには、payment_method_types に interac_present も含める必要があります。詳細については、カナダのドキュメントをご覧ください。

PaymentIntent には、個々の PaymentIntent に固有のキーである client secret が含まれています。client secret を使用するには、これをサーバーで PaymentIntent から取得し、クライアント側に渡す必要があります。

post '/create_payment_intent' do
  intent = # ... Create or retrieve the PaymentIntent
  {client_secret: intent.client_secret}.to_json
end

collectPaymentMethod を呼び出す際に、client secret をパラメーターとして使用します。

決済手段の収集に進むためにクライアント側アプリケーションで必要なものは、client_secret だけです。

PaymentIntent を作成したら、次のステップは SDK で決済手段を収集することです。

決済手段を収集するには、アプリがリーダーに接続されている必要があります。アプリが collectPaymentMethod を呼び出した後、接続されたリーダーはカードの提示を待ちます。

async () => {
  // clientSecret is the client_secret from the PaymentIntent you created in Step 1.
  const result = await terminal.collectPaymentMethod(clientSecret);
  if (result.error) {
    // Placeholder for handling result.error
  } else {
    // Placeholder for processing result.paymentIntent
  }
}

この方法では、接続されたカードリーダーを使用して暗号化された決済手段のデータを収集し、その暗号化されたデータをローカルの PaymentIntent に関連付けます。

支払い方法の詳細をオプションで調査する

高度なユースケースでは、提示されたカードの支払い方法の詳細を調査し、オーソリ前に自社のビジネスロジックを実行できます。

update_payment_intent パラメーターを使用して、PaymentMethod をサーバー側の PaymentIntent に関連付けます。このデータは collectPaymentMethod レスポンスで返されます。

async () => {
  // clientSecret is the client_secret from the PaymentIntent you created in Step 1.
  const result = await terminal.collectPaymentMethod(clientSecret, {
    config_override: {
      update_payment_intent: true
    }
  });
  if (result.error) {
    // Placeholder for handling result.error
  } else {
    const pm = result.paymentIntent.payment_method
    const card = pm?.card_present ?? pm?.interac_present

    // Placeholder for business logic on card before processing result.paymentIntent
  }
}

この時点で、カードブランド、口座情報、その他の役立つデータなどの属性にアクセスできます。

収集をキャンセルする

プログラムによるキャンセル

JavaScript SDK で cancelCollectPaymentMethod を呼び出すと、決済手段の収集をキャンセルできます。

顧客によるキャンセル

取引の enable_customer_cancellation を true に設定すると、スマートリーダーのユーザーにキャンセルボタンが表示されます。

キャンセルボタンをタップすると、現在の取引がキャンセルされます。

terminal.collectPaymentMethod(
  clientSecret,
  {
    config_override: {
      enable_customer_cancellation: true
    }
  }
)

イベントを処理する

顧客から決済手段を収集したら、次のステップに進み、SDK で支払いを処理します。支払いを続行する準備ができたら、ステップ 2 の更新後の PaymentIntent を使用して processPayment を呼び出します。

• 支払いの手動キャプチャーでは、processPayment コールが成功すると、PaymentIntent のステータスが requires_capture になります。
• 支払いの自動キャプチャーでは、PaymentIntent は succeeded 状態に移行します。

async () => {
  const result = await terminal.processPayment(paymentIntent);
  if (result.error) {
    // Placeholder for handling result.error
  } else if (result.paymentIntent) {
    // Placeholder for notifying your backend to capture result.paymentIntent.id
  }
}

失敗に対処する

決済の処理に失敗すると、SDK は更新された PaymentIntent を含むエラーを返します。アプリケーションは PaymentIntent を調べて、エラーへの対処方法を決定する必要があります。

タイムアウトが複数回、連続して発生する場合、接続に問題がある可能性があります。アプリがインターネットと通信できることを確認してください。

二重支払いの防止

PaymentIntent オブジェクトは、Stripe での資金移動を可能にします。1 つの取引を表すには、PaymentIntent を 1 つ使用します。

カードが (残高不足などのために) 拒否された後、同じ PaymentIntent を再利用して、顧客が別のカードで再試行できるようにします。

PaymentIntent を編集する場合は、collectPaymentMethod を呼び出してリーダー上の決済情報を更新する必要があります。

PaymentIntent は、Stripe で処理する前に requires_payment_method ステータスである必要があります。承認済み、キャプチャー済み、キャンセル済みの PaymentIntent はリーダーで処理できません。

ステップ 1 の PaymentIntent の作成時に capture_method を manual として定義した場合、SDK はオーソリ済みでキャプチャーはされていない PaymentIntent をアプリケーションに返します。オーソリとキャプチャーの違いについて、詳細を確認してください。

アプリが SDK から確定済みの PaymentIntent を受信したら、その支払いをキャプチャーするようにアプリからバックエンドに対して通知するようにしてください。バックエンドにエンドポイントを作成し、PaymentIntent ID を受け付け、それをキャプチャーするように Stripe API にリクエストを送信します。

curl -X POST https://api.stripe.com/v1/payment_intents/{{PAYMENT_INTENT_ID}}/capture \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

capture コールが成功すると、PaymentIntent のステータスは succeeded になります。

支払いを照合する

ビジネスの支払いアクティビティを監視するため、毎日の最後の作業としてサーバで PaymentIntent と内部注文システムを照合することをお勧めします。

PaymentIntent のステータスが requires_capture のままの場合には、以下の 2 つの可能性があります。

顧客のカード明細上の不要なオーソリ

• 原因: ユーザーが取引の途中でアプリの決済フローを中止した
• 解決策:キャプチャーされていない PaymentIntent が、サーバーにある完了済みの注文に関連付けられていない場合には、キャンセルできます。キャンセルされた PaymentIntent を使用して支払いを実行することはできません。

顧客からの売上回収が未完了

• 原因: 支払いをキャプチャーするようにバックエンドに通知する、アプリからのリクエストのエラー
• 解決策:キャプチャーされていない PaymentIntent が、サーバにある完了済みの注文に関連付けられており、その注文について他の支払い (現金による支払いなど) を受けていない場合には、この PaymentIntent をキャプチャーできます。

チップを徴収する アメリカのみ

アメリカでは、対象ユーザーは支払いのキャプチャー時にチップを徴収できます。