その他の支払い方法公開プレビュー

Terminal のスマートリーダーにQR コードを表示して、サポートされている支払い方法を受け付けます。

Terminal のスマートリーダーは、カード以外にも支払い方法の取引固有の QR コードを表示できます。顧客はこのコードをスキャンして、モバイルデバイスで購入を完了できます。

The flow below shows a payment that supports both card and non-card payment methods. Alternatively, if you want to support multiple non-card payment methods without accepting cards, the reader bypasses the tap or insert prompt and instead shows the menu of non-card payment method options. If you want to support a single non-card payment method, the reader loads the QR code directly.

支払い方法の画面を収集する

決済手段の選択画面

読み込み画面

QR コードのスキャン画面

承認済みの画面

サポートされている支払い方法: WeChat Pay、Affirm

サポート対象のリーダー: Stripe Reader S700、BBPOS WisePOS E

注

Connect アカウントには、各決済手段の取引を実行するための必須ケイパビリティが必要です。Connect と Affirm および WeChat Pay との互換性について、詳しくはこちらをご覧ください。

Stripe Terminal でカード以外の決済手段をテストするには、物理リーダーを使用します。シミュレートされたリーダーはサポートされていません。

All transactions must be made with a functional network connection, i.e. not while offline.

Create a PaymentIntent

To accept non-card payment methods through the QR code interface, create a PaymentIntent and include your preferred payment method types in the payment_method_types parameter.

To present your customer all payment method options in the checkout flow, combine card_present with non-card payment method types (affirm, wechat_pay). We recommend enabling this if you operate in a heavily offline environment because only cards are supported in offline mode.
If you don’t want to accept cards, support only non-card payment method types (affirm, wechat_pay).
If you know which payment method you want to direct your customer to checkout to, select a single payment method type.

注

To process payments supporting both card_present and non-card payment_method_types, the reader application must be at least 2.30.5.0. To process payments supporting only non-card payment_method_types, the reader application must be at least 2.31.6.0.

Capture type

Many payment methods don’t support manual capture. Create your PaymentIntent with the capture_method parameter automatic to support the broadest set of payment methods. To support manual capture for card payments while also accepting payment methods that require automatic capture, set capture_method on the nested payment_method_options.card_present attribute to manual.

Handle the payment

Unlike card payments, processing QR code payments occurs asynchronously. When processing a PaymentIntent with a QR code payment method, Stripe generates a QR code unique to that payment. After processing the payment, the reader displays the QR code for the customer to scan with their mobile device. Shortly after the customer completes the payment on their device, the reader updates to reflect the completed payment.

注

The time it takes for the reader to display the result of the payment might differ depending on the payment method used. The reader usually updates after a few seconds.

QR code payments support both processing the payment immediately and the two-step collect-and-confirm flow.

To collect payment, make a request to Stripe with the ID of the PaymentIntent you created and the reader you want to use for the transaction.

Some payment methods (for example, Affirm) require a return_url when confirming a PaymentIntent to redirect your customer to after they authenticate or cancel their payment on the payment method’s app or site. You can provide your own return_url when processing the PaymentIntent. If you don’t provide one, the customer sees a generic landing page hosted by Stripe.

When you process a payment, Stripe immediately responds to the request with an HTTP 200 status code as an acknowledgement that the reader received the action. In most cases, the request returns a reader with an in_progress status. However, because processing occurs asynchronously, the action status might already reflect the final state (succeeded or failed) if the payment completes quickly.

Simultaneously, the reader screen switches to a UI that prompts the customer to insert their card or select a QR code payment method. For QR code payments, the customer completing the payment on their device updates the status of the payment. To verify the reader state, listen to the terminal.reader.action_succeeded webhook or poll the Reader and PaymentIntent status to receive the status of the payment.

{
  "id": "tmr_xxx",
  "object": "terminal.reader",
  ...
  "status": "online",
  "action": {
    "type": "process_payment_intent",
    "process_payment_intent": {
      "payment_intent": "pi_xxx"
    },
    "status": "in_progress",
    "failure_code": null,
    "failure_message": null
  }
}

顧客体験

After you process the PaymentIntent, the customer scans a QR code rendered on the reader screen. Depending on the payment method, the customer might quickly finalize the payment in their mobile application (most digital wallets), or complete a more extended process of evaluating financing offers (BNPL payment methods). Below are demonstrations of the payment flow for supported payment methods:

Learn more about how to provide the best customer experience and promote awareness of BNPL options in a store through these Affirm training resources.

テスト

In a sandbox, you can scan the QR code using a regular QR code scanning application on your mobile phone. The QR code payload contains a URL that takes you to one of these test payment pages:

Affirm-hosted sandbox page: If your account is onboarded with Affirm, the QR code URL takes you to an Affirm-hosted sandbox page where you can complete the payment process. When you’re redirected to the Affirm sandbox, you might receive a prompt to enter the last four digits of your SSN. Affirm recommends using either 0000 or 5678 for testing purposes.
Stripe-hosted test payment page: If your account isn’t onboarded with Affirm, you’ll be directed to a Stripe-hosted test payment page where you can choose to authorize or decline the test payment.

注

The present_payment_method endpoint doesn’t support specifying QR code payment method types.