Revisar os pagamentos não capturados

Por padrão, você cria pagamentos em uma única etapa. Você não precisa fazer mais nada para enviar fundos para sua conta bancária. A Stripe também suporta pagamentos em duas etapas, geralmente chamados de autorização e captura. Se a sua integração usar esse método, a aprovação de uma revisão e a captura de um pagamento são ações separadas.

Your capture window for approved payments varies by card brand, potential extended holds, and payment method type.

Revisar os pagamentos não capturados no Dashboard

Quando colocamos um pagamento não capturado em revisão, o Stripe Dashboard mostra um botão Captura ao lado de botões para aprovar ou cancelar a revisão. Os pagamentos não capturados mostram um botão Cancelar em vez de um botão Reembolsar porque o cancelamento de um pagamento não capturado libera a autorização sem criar um objeto de reembolso .

Use a API para capturar automaticamente os pagamentos aprovados

Na API, você pode configurar a integração para:

• Capturar imediatamente payments_not_placed para review.
• Deixe os pagamentos enviados para review sem captura
• Capturar o pagamento após a aprovação da revisão

Capture imediatamente pagamentos não enviados para revisão

Defina o capture_method em sua solicitação de API para criar um pagamento não capturado. Após uma solicitação bem-sucedida, verifique o atributo revisão no PaymentIntent. Se ele estiver vazio, capture a cobrança.

# Don't put any keys in code. Use a secrets vault or environment
# variable to supply keys to your integration. This example
# shows how to set a secret key for illustration purposes only.
#
# See https://docs.stripe.com/keys-best-practices and find your
# keys at 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

Capturar um pagamento após a aprovação de uma revisão

Na etapa anterior, você deixou os pagamentos em review e não foram capturados. Use webhooks para capturar automaticamente esses pagamentos após a aprovação.

Configure seus Webhooks para ver o evento review.closed. O evento inclui o objeto Revisão, e seu atributo reason indica se a revisão foi aprovada ou fechada por outro motivo (por exemplo, o pagamento foi reembolsado).

// 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"
}

Se reason for approved, capture a cobrança.

# Don't put any keys in code. Use a secrets vault or environment
# variable to supply keys to your integration. This example
# shows how to set a secret key for illustration purposes only.
#
# See https://docs.stripe.com/keys-best-practices and find your
# keys at 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