キャプチャされていない決済のレビュー

デフォルトでは、1 ステップで 決済を作成 します。銀行口座に資金を送金するために、他に必要な操作はありません。Stripe は、オーソリとキャプチャ と呼ばれる 2 ステップの決済もサポートしています。導入でこの方法を使用する場合、レビューの承認と決済のキャプチャは別のアクションです。

承認された決済をキャプチャする期間は、カードブランド、保留の延長 の可能性、決済手段タイプ によって異なります。

キャプチャされていない決済をダッシュボードでレビュー

キャプチャされていない決済をレビュー対象にすると、Stripe ダッシュボードではレビューを承認またはキャンセルするボタンの横に キャプチャ ボタンが表示されます。キャプチャされていない決済をキャンセルすると、Refund オブジェクト を作成せずにオーソリが解除されるため、キャプチャされていない決済には 返金 ボタンではなく キャンセル ボタンが表示されます。

API を使用して承認済みの決済を自動キャプチャする

API を使用して、組み込みが以下に対応できるように設定できます。

• review に配置 _ されていない_ 決済を即座にキャプチャする
• 審査 対象となった決済をキャプチャしないままにする。
• 審査が承認されたら、決済をキャプチャする。

審査対象外の決済を即座にキャプチャする

API リクエストで capture_method を設定し、キャプチャされていない決済を作成します。リクエストが成功したら、PaymentIntent の review 属性を確認します。空の場合は、決済をキャプチャします。

# Set your secret key. Remember to switch to your live secret key in production.
# See your keys here: https://dashboard.stripe.com/apikeys
Stripe.api_key = 
'sk_test_BQokikJOvBiI2HlWgH4olfQ2'

# Get the credit card details submitted by the form
# Create a PaymentIntent with manual capture
payment_intent = Stripe::PaymentIntent.create({
  amount: 1000,
  currency: 'usd',
  payment_method: '{{PAYMENT_METHOD_ID}}',
  description: 'Example charge',
  confirm: true,
  capture_method: 'manual',
})

# Check if the payment is in review. If not, capture it.
if !payment_intent.review
  payment_intent.capture
end

レビュー承認後の決済をキャプチャする

前のステップでは、決済を review 中およびキャプチャしていないままにしました。承認後にこれらの決済を自動的にキャプチャするには、webhook を使用します。

review.closed イベントをリッスンするように webhook を設定します。このイベントには Review オブジェクト が含まれ、その reason 属性は、レビューが承認されたか、別の理由 (決済が返金されたなど) で終了したかを示します。

// Review object included in review.closed event webhook.
{
  "id": "prv_08voh1589O8KAxCGPcIQpmkz",
  "object": "review",
  "payment_intent": "pi_1D0CsEITpIrAk4QYdrWDnbRS",
  "created": 1474379631,
  "livemode": false,
  "open": false,
  "reason": "approved"
}

reason が approved の場合、支払いをキャプチャします。

# Set your secret key. Remember to switch to your live secret key in production.
# See your keys here: https://dashboard.stripe.com/apikeys
Stripe.api_key = 
'sk_test_BQokikJOvBiI2HlWgH4olfQ2'

post "/my/webhook/url" do
  event_json = JSON.parse(request.body.read)
  event = Stripe::Event.retrieve(event_json["id"])

  if event.type == 'review.closed'
    review = event.object
    if review.reason == 'approved'
      pi = Stripe::PaymentIntent.retrieve(review.payment_intent)
      pi.capture
    end
  end

  status 200
end