Boleto 支払い

Boleto 支払いに対応するには、Checkout セッションが次の条件をすべて満たしている必要があります。

• すべてのラインアイテムの価格が、同じ通貨である必要があります。異なる通貨のラインアイテムが存在する場合は、通貨ごとに別の Checkout セッションを作成します。
• 使用できるのは単一の項目だけです (継続的なサブスクリプションプランには対応していません)。

このガイドでは、Boleto を有効にする方法を紹介します。カード決済の受け付ける場合と Boleto を使用する場合の違いも説明します。

支払い方法として Boleto を有効にする

新しい Checkout セッションを作成する際は、以下を行う必要があります。

1. boleto を payment_method_types のリストに追加します。
2. すべての line_items が brl 通貨を使用していることを確認します。

Stripe::Checkout::Session.create({
  mode: 'payment',
  payment_method_types: ['card'],
  payment_method_types: ['card', 'boleto'],
  # The parameter is optional. The default value of expires_after_days is 3.
  payment_method_options: {
    boleto: {
      expires_after_days: 7
    }
  },
  line_items: [{
    price_data: {
      # To accept `boleto`, all line items must have currency: brl
      currency: 'brl',
      product_data: {
        name: 'T-shirt',
      },
      unit_amount: 2000,
    },
    quantity: 1,
  }],
  success_url: 'https://example.com/success',
  cancel_url: 'https://example.com/cancel',
})

その他の支払い方法オプション

Session の決済手段オプションでオプションの expires_after_days パラメータを指定すると、Boleto 支払い票の有効期限が切れるまでの暦日数を設定できます。たとえば、月曜日に Boleto の支払い票を作成し、expires_after_days を 2 に設定した場合、Boleto の支払い票は水曜日のアメリカ/サンパウロ時間 (UTC-3) の 23:59 に有効期限が切れます。0 に設定すると、その日の終わりに Boleto の支払い票の有効期限が切れます。expires_after_days パラメーターは 0 日から 60 日までの範囲で設定できます。既定値は 3 日です。アカウントのデフォルトの有効期限は、決済手段の設定でカスタマイズできます

Stripe がオンラインで提供する取引の詳細ページにリダイレクトする

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 の組み込みをテストする際は、支払い方法として Boleto を選択して、支払うボタンをクリックします。

Boleto での支払いは返金できません。一部の加盟店では、直接問い合わせた顧客にクレジットを提供するプロセスを別途作成しています。

Boleto での支払いに関して、顧客が不審請求を申請することはできません。