Boleto 支払い
注意
Stripe は、顧客の通貨、決済手段の制限、その他のパラメーターを評価して、決済手段オプションを自動的に提示します。決済を受け付けるの手順を使用して、Stripe ダッシュボードから決済手段を設定することをお勧めします。
引き続き、Checkout で顧客に提示する決済手段を手動で設定する必要がある場合は、こちらのガイド (たとえば、_「サブスクリプション」_モードでの決済の受け付け) を使用します。それ以外の場合は、ダッシュボードに移行します。
Boleto は 1 回限りの使用の支払い方法であり、顧客が支払いを完了するには、追加の手順を実行する必要があります。顧客は、ATM、銀行、オンラインバンクポータル、または公認の代理店のいずれかで、生成された番号が記載された Boleto の支払い票を使用して支払います。
支払いを受け付ける
注
このガイドを使用する前に、まず Checkout で決済を受け付ける実装を構築します。
Use this guide to learn how to enable Boleto—it shows the differences between accepting a card payment and using Boleto.
支払い方法として Boleto を有効にする
新しい Checkout セッションを作成する際に、以下を実行する必要があります。
boleto
をpayment_method_types
のリストに追加します。- すべての
line_items
がbrl
通貨を使用していることを確認します。
その他の支払い方法オプション
You can specify an optional expires_after_days
parameter in the payment method options for your Session
that sets the number of calendar days before a Boleto voucher expires. For example, if you create a Boleto voucher on Monday and you set expires_after_days
to 2, the Boleto voucher expires on Wednesday at 23:59 America/Sao_Paulo (UTC-3) time. If you set it to 0, the Boleto voucher expires at the end of the day. The expires_after_days
parameter can be set from 0 to 60 days. The default is 3 days. You can customize the default expiration days on your account in the Payment methods settings
Stripe がオンラインで提供する取引の詳細ページにリダイレクトする
注
カード支払いと異なり、Boleto 支払いでは顧客は success_url にリダイレクトされません。
Checkout フォームの送信に成功すると、顧客は hosted_voucher_url
にリダイレクトされます。顧客はオンラインの取引詳細ページから Boleto 番号をコピーしたり、支払い票の PDF をダウンロードしたりできます。
Stripe は、Boleto の取引の詳細が正常に作成されると、payment_intent.requires_action イベントを送信します。顧客にリンクをメールで送信する必要がある場合は、payment_intent.next_action.boleto_display_details の hosted_voucher_url
に取引詳細へのリンクが含まれています。Webhook で PaymentIntent を監視する方法については、こちらでご紹介しています。
Stripe では、ブランディング設定 ページで顧客に表示される UI をカスタマイズすることができます。取引の詳細には、以下のブランド設定を適用できます。
- アイコン—ブランド画像と公開ビジネス名
- アクセントカラー— 番号コピーボタンのカラーとして使用されます
- ブランドカラー—背景色として使用されます
注文のフルフィルメントを行う
Boleto は遅延通知型の支払い方法であるため、Webhook などの方法を使用して支払いステータスを監視し、注文のフルフィルメントを行う必要があります。Webhook の設定と注文のフルフィルメントで詳細をご覧ください。
支払いのステータスに変化があると、以下のイベントが送信されます。
イベント名 | 説明 | 次のステップ |
---|---|---|
顧客が Checkout フォームの送信を完了しました。Stripe が Boleto 支払い向けに取引の詳細を生成しています。 顧客が Boleto の取引の詳細を紛失した場合に備え、顧客に | 顧客が Boleto の支払いを行うのを待っています。 | |
checkout.session.async_payment_succeeded | 顧客は Boleto の支払いを完了しました。PaymentIntent が succeeded に移行します。 | 顧客が購入した商品またはサービスのフルフィルメントを行います。 |
checkout.session.async_payment_failed | Boleto 支払いの有効期限が切れたか、その他の理由で支払いが失敗しました。PaymentIntent のステータスは requires_payment_method に戻ります。 | メールで顧客に連絡して、新たに注文をするようにリクエストします。 |
組み込みをテストする
Checkout の組み込みをテストする際は、支払い方法として Boleto を選択して、支払うボタンをクリックします。
メールアドレス | 説明 |
---|---|
| 顧客が 3 分後に支払い、約 3 分後に 例: fulaninho@example.com |
| 顧客が即座に支払い、数秒以内に 例: succeed_immediately@example.com |
| 顧客が支払う前に期限切れになり、数秒以内に next_action.boleto_display_details の 例: expire_immediately@example.com |
| 顧客が支払う前に期限切れになり、約 3 分後に next_action.boleto_display_details の 例: expire_with_delay@example.com |
| 絶対に成功しない Boleto の支払いをシミュレーションします。支払い方法オプションで指定されたパラメーターに基づき、next_action.boleto_display_details の 例: fill_never@example.com |
納税者番号 | 説明 |
---|---|
CPF CNPJ | テスト環境で、 |
返金を処理する
Boleto での支払いは返金できません。一部の加盟店では、直接問い合わせた顧客にクレジットを提供するプロセスを別途作成しています。
不審請求の申請を処理する
Boleto での支払いに関して、顧客が不審請求を申請することはできません。