Multibanco による決算を受け付ける
Multibanco による支払い方法を受け付ける方法をご紹介します。
注意
Stripe automatically presents your customers payment method options by evaluating their currency, payment method restrictions, and other parameters. We recommend that you configure your payment methods from the Stripe Dashboard using the instructions in Accept a payment.
If you want to continue manually configuring the payment methods you present to your customers with Checkout, use this guide. Otherwise, migrate to the Dashboard.
Multibanco は、ポルトガルにおける店舗支払いに基づく決済手段です。ビジネスがヨーロッパまたはアメリカを拠点にしている場合、Payment Intents API を使用して、ポルトガルの顧客から Multibanco による決済を受け付けることができます。
取引を完了するために、顧客は Multibanco の法人番号と参照番号が記載された支払い票を受け取ります。顧客はこれらの店舗支払いの詳細を使用して、オンラインバンキングまたは ATM での決済フロー以外の支払いを行います。
顧客が Multibanco の取引詳細に応じて支払いを行う際、銀行振込が開始されるため、支払いの確定が数日遅れる場合があります。銀行振込は特に週末に遅延が発生することがあります。これは支払い確定の遅延の一因になります。
決済を受け付ける
注
このガイドを使用する前に、まず Checkout で決済を受け付けるための実装を構築します。
カード支払いの実装状態を次のように更新して、Multibanco を有効にします。
支払い方法として Multibanco を有効にする
新しい Checkout セッションを作成する際は、以下を行う必要があります。
- Add
multibancoto the list ofpayment_.method_ types - すべての
line_がitems eur通貨を使用していることを確認します。
Redirect to Stripe-hosted voucher page
注
Unlike card payments, the customer won’t be redirected to the success_url with a Multibanco payment.
Checkout フォームの送信に成功すると、顧客は hosted_ にリダイレクトされます。顧客はオンラインで提供されるページに記載されている支払い手順書を参照して、支払いを完了する詳しい方法を確認できます。このページはデスクトップとモバイルの両方のプラットフォームで見ることができ、印刷も可能です。
Stripe sends a payment_intent.requires_action event when a Multibanco voucher is created successfully. If you need to send an email with the voucher’s payment instructions link, locate the PaymentIntent at data. on the requires_ event, and extract the hosted_ at next_action.multibanco_display_details.hosted_voucher_url on the PaymentIntent.
注文のフルフィルメントを実行する
Because Multibanco is a delayed notification payment method, you need to use a method such as webhooks to monitor the payment status and handle order fulfillment. Learn more about setting up webhooks and fulfilling orders.
支払いステータスに変化があると、以下のイベントが送信されます。
| イベント名 | 説明 | 次のステップ |
|---|---|---|
| checkout.session.completed | The customer has successfully submitted the Checkout form. Stripe has generated a Multibanco voucher. | 顧客が Multibanco で支払うのを待ちます。 |
| checkout.session.async_payment_succeeded | 顧客が Multibanco を完了しました。PaymentIntent が succeeded に移行します。 | 顧客が購入した商品またはサービスのフルフィルメントを行います。 |
| checkout.session.async_payment_failed | Multibanco 支払いの有効期限が切れたか、その他の理由で支払いが失敗しました。PaymentIntent のステータスは requires_ に戻ります。 | Contact the customer by email and request that they place a new order. |
実装内容をテストする
When testing your Checkout integration, select Multibanco as the payment method, then click Pay. Provide the following email patterns in the Checkout form to test different scenarios:
| メール | 説明 |
|---|---|
| Simulates a Multibanco voucher that a customer pays. The 例: jenny#example.com |
| Simulates a Multibanco voucher that a customer pays immediately. The 例: succeed_immediately@example.com |
| Simulates a Multibanco voucher that expires immediately. The 例: expire_immediately@example.com |
| Simulates a Multibanco voucher that expires before a customer pays. The 例: expire_with_delay@example.com |
| Simulates a Multibanco voucher that never succeeds. The 例: fill_never@example.com |
有効期限
Multibanco vouchers expire at the expires_ UNIX timestamp in next_action.multibanco_display_details.expires_at, which is 7 days after you create the voucher. Customers can’t pay a Multibanco voucher after it expires. After expiration, the PaymentIntent’s status transitions from requires_ to processing, and Stripe sends a payment_intent.processing event.
The PaymentIntent remains in the processing status for a maximum buffer period of 4 days to allow for potential completed payment notification delays caused by bank-transfer delays. If the Multibanco payment doesn’t complete within the buffer period, the PaymentIntent’s status transitions to requires_ and Stripe sends a payment_intent.payment_failed event. If you receive the customer’s funds after the buffer period, Stripe automatically initiates a refund process for the mispaid amount.
キャンセル
You can cancel Multibanco vouchers using Cancel a PaymentIntent. After cancelation, Stripe sends a payment_intent.canceled event.
If a customer’s funds are received for a canceled Multibanco voucher, Stripe automatically initiates a refund process for the mispaid amount.
注
Canceling a pending payment invalidates the original voucher instructions. When you cancel a pending Multibanco payment, inform your customer.
When you successfully reconfirm a PaymentIntent in status requires_, Stripe creates new voucher instructions and a new hosted_. You must provide them to your customer.