Boleto 支払い

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

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

Use this guide to learn how to enable Boleto—it shows the differences between accepting a card payment and using 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',
})

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

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 がオンラインで提供する取引の詳細ページにリダイレクトする

Checkout フォームの送信に成功すると、顧客は hosted_voucher_url にリダイレクトされます。顧客はオンラインの取引詳細ページから Boleto 番号をコピーしたり、支払い票の PDF をダウンロードしたりできます。

Stripe sends a payment_intent.requires_action event when a Boleto voucher is created successfully. If you need to email your customers the voucher link, you can locate the hosted_voucher_url in payment_intent.next_action.boleto_display_details. Learn more about how to monitor a PaymentIntent with webhooks.

Stripe では、ブランディング設定 ページで顧客に表示される UI をカスタマイズすることができます。取引の詳細には、以下のブランド設定を適用できます。

• アイコン—ブランド画像と公開ビジネス名
• アクセントカラー— 番号コピーボタンのカラーとして使用されます
• ブランドカラー—背景色として使用されます

注文のフルフィルメントを行う

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

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

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