銀行振込を受け付ける

まず、Stripe アカウントが必要です。今すぐ登録してください。

アプリケーションから Stripe API にアクセスするには、Stripe の公式ライブラリを使用します。

# Available as a gem
sudo gem install stripe

# If you use bundler, you can add this line to your Gemfile
gem 'stripe'

銀行振込による各支払いを消し込むには、Customer (顧客) オブジェクトを関連付ける必要があります。すでに Customer オブジェクトが存在する場合は、このステップをスキップできます。ない場合は、新しい Customer オブジェクトを作成します。

curl -X POST https://api.stripe.com/v1/customers \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:"

PaymentIntent は、顧客から支払いを回収するお客様の意図を表すオブジェクトであり、支払いプロセスのライフサイクルの各段階を追跡します。回収する金額と通貨を指定して、お客様のサーバーで PaymentIntent を作成して確定してください。PaymentIntent 作成リクエストの customer パラメーターにも入力する必要があります。銀行振込は、顧客が指定されていない PaymentIntent では利用できません。

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d amount=1099 \
  -d customer=
{{CUSTOMER_ID}} \
  -d currency=usd \
  -d "automatic_payment_methods[enabled]"=true \
  --data-urlencode return_url="https://example.com/return_url" \
  -d "payment_method_data[type]"=customer_balance \
  -d confirm=true

顧客の残高がリクエスト金額をまかなうのに十分な金額でない場合、PaymentIntent は requires_action ステータスを表示します。レスポンスには display_bank_transfer_instructions の type 値を持つ next_action フィールドが含まれます。next_action[display_bank_transfer_instructions] ハッシュには、銀行振込を完了できるように顧客に表示される情報が含まれています。

{
  "aba": {
    "account_number": "111222333444",
    "bank_name": "Wells Fargo Bank, NA",
    "routing_number": "444555666"
  },
  "supported_networks": [
    "ach",
    "domestic_wire_us"
  ],
  "type": "aba"
}

{
  "swift": {
    "account_number": "111222333444",
    "bank_name": "Wells Fargo Bank, NA",
    "swift_code": "AAAA-BB-CC-123"
  },
  "supported_networks": [
    "swift"
  ],
  "type": "swift"
}

PaymentIntent は、売上が銀行口座に入金されるまで requires_action ステータスのままとなります。売上の準備ができると、PaymentIntent のステータスが requires_action から succeeded に更新されます。

payment_intent.partially_funded イベントの受信を開始するには、Webhook エンドポイントを設定する必要があります。

ダッシュボードから Webhook を追加できます。

また、Webhook Endpoint API を使用して payment_intent.partially_funded イベントの受信を開始することもできます。

PaymentIntent が更新されると、Stripe は、以下のイベントを支払い資金追加フロー中に送信します。

支払いが成功したことを確認し、顧客に支払い完了を通知するには、Webhook を使用することをお勧めします。

サンプルコード

require 'json'

# Using Sinatra
post '/webhook' do
  payload = request.body.read
  event = nil

  begin
    event = Stripe::Event.construct_from(
      JSON.parse(payload, symbolize_names: true)

ダッシュボードで保留中の支払いを表示する

ダッシュボードでステータスに資金供給待ちのフィルターを適用すると、保留中のすべての銀行振込 PaymentIntent を表示できます。

ダッシュボードまたは HTTP リクエストを使用して、銀行振込の受け取りをシミュレーションすることにより、お使いの組み込みをテストできます。

curl https://api.stripe.com/v1/test_helpers/customers/ic_xxxxxxxxx/fund_cash_balance \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d amount=1000 \
  -d currency=usd \
  -d reference=REF-4242

次のエラーコードは、その支払い方法が一時的に使用できない状態にあることを示しています。