Fazer uma reserva em uma forma de pagamento

Ao criar um pagamento, você pode fazer uma retenção em uma forma de pagamento qualificada para reservar fundos que podem ser capturados posteriormente. Por exemplo, os hotéis geralmente autorizam um pagamento total antes da chegada do hóspede e capturam o dinheiro quando ele faz o checkout. Às vezes, isso é chamado de captura manual.

A autorização de um pagamento garante o valor mantendo-o na forma de pagamento do cliente. Se você estiver usando a API, o atributo payment_method_details.card.capture_before na cobrança indica quando a autorização expira.

Você precisa capturar os fundos antes que a autorização expire. Se a autorização expirar antes de você capturar os fundos, os fundos serão liberados e o status do pagamento mudará para canceled. Saiba mais sobre os status de pagamentos assíncronos.

Períodos de validade da autorização

As tabelas a seguir descrevem janelas de validade para autorizar diferentes tipos de transação.

Transações sem apresentação do cartão

Transações com apresentação de cartão (pagamentos presenciais)

Janelas de autorização de 30 dias no Japão

Se sua conta estiver estabelecida no Japão, você pode reter transações em JPY da Visa, Mastercard, JCB, Diners Club e Discover por até 30 dias. Transações em moedas diferentes de JPY e da American Express expiram após a janela padrão de 7 dias.

Limitações das formas de pagamento

Antes de implementar, entenda as seguintes limitações para autorização e captura separadas.

• Apenas algumas formas de pagamento aceitam autorização e captura separadas. Algumas formas de pagamento que aceitam isso incluem cartões, Affirm, Afterpay, Cash App Pay, Klarna e PayPal. Algumas formas de pagamento que não aceitam esse recurso são ACH e iDEAL. Leia mais sobre o suporte a recursos de forma de pagamento.

• Além do que está descrito nas tabelas acima, outras formas de pagamento têm regras e janelas de autorização diferentes:

  • Pagamentos com cartão: Normalmente, o valor fica retido por 7 dias para pagamentos online e 2 dias para pagamentos presenciais no Terminal (dependendo do tipo de transação e da bandeira do cartão). Você pode solicitar uma autorização estendida para determinadas autorizações de pagamento online e do Terminal qualificadas por períodos de validade estendidos. As bandeiras de cartão também podem restringir autorizações de US$ 1 que você não pretende capturar.
  • Affirm: se o Affirm exigir uma entrada para valores muito altos do pedido, o valor será cobrado durante a autorização e reembolsado se o pagamento não for capturado. Em seguida, você tem 30 dias para capturar o saldo do pagamento.
  • Afterpay/Clearpay: durante a autorização, o cliente paga a primeira parcela de pagamento. O Afterpay reembolsa o pagamento se ele nunca for capturado. Em seguida, você tem 13 dias para capturar o saldo do pagamento.
  • Cash App Pay: as autorizações válidas devem ser capturadas em até 7 dias para a conclusão de um pagamento.
  • Klarna: você deve capturar a cobrança até a meia-noite do 28º dia corrido após a solicitação de cobrança. Caso contrário, a autorização expira. Por exemplo, você precisaria capturar uma solicitação de cobrança em UTC 2020-10-01 14:00 até UTC 2020-10-29 00:00.
  • PayPal: retém o valor por 10 dias. A Stripe tenta estender automaticamente a retenção por mais 10 dias, totalizando 20 dias. Sua preferência de liquidação pode afetar o período de autorização. Consulte autorização e captura separadas para obter mais informações.

Use o Dashboard para autorizar e capturar

Você pode autorizar um pagamento e capturar os fundos separadamente sem precisar de programação.

1. No Dashboard, crie um pagamento. Selecione Avulso.
2. Quando inserir ou selecionar a forma de pagamento, selecione Mais opções e Capturar fundos mais tarde.

O pagamento aparece na sua página de pagamentos como Não capturado.

Para capturar os fundos, vá até a página de detalhes do pagamento e clique em Capturar.

Instruir a Stripe a autorizar somente

Para indicar que você quer separar a autorização da captura, especifique capture_method como manual ao criar o PaymentIntent. Esse parâmetro instrui a Stripe a autorizar o valor, mas não a capturá-lo na forma de pagamento do cliente.

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=1099 \
  -d currency=usd \
  -d "payment_method_types[]"=card \
  -d capture_method=manual

Com a abordagem acima, você informa à Stripe que só pode usar “capturar depois” para um PaymentIntent com formas de pagamento qualificadas. Por exemplo, você não pode aceitar pagamentos com cartão e débito automático SEPA (que não aceita a captura posterior) para um único PaymentIntent. Para aceitar formas de pagamento que talvez não permitam capturar depois, você pode configurar a captura depois por pagamento configurando capture_method=manual no objeto payment_method_options[<payment_method_type>].

Por exemplo, ao configurar payment_method_options[card][capture_method]=manual, você suspende apenas pagamentos com cartão. Você pode gerenciar formas de pagamento no Dashboard. A Stripe gerencia a lógica para exibir dinamicamente as formas de pagamento qualificadas mais relevantes para cada cliente com base em fatores como valor, moeda e fluxo de pagamento da transação.

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=1099 \
  -d currency=usd \
  -d "automatic_payment_methods[enabled]"=true \
  -d "payment_method_options[card][capture_method]"=manual

Alternativamente, você pode listar card e sepa_debit usando tipos de forma de pagamento como no exemplo abaixo.

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=1099 \
  -d currency=eur \
  -d "payment_method_types[]"=card \
  -d "payment_method_types[]"=sepa_debit \
  -d "payment_method_options[card][capture_method]"=manual

Antes de continuar com a captura, anexe uma forma de pagamento com dados do cartão ao PaymentIntent e confirme o PaymentIntent para autorizar o cartão. Isso pode ser feito definindo os campos payment_method e confirm no PaymentIntent.

Capturar os fundos

Após a autorização da forma de pagamento, o status do PaymentIntent passa para requires_capture. Para capturar os fundos autorizados, faça uma solicitação de captura do PaymentIntent. Isso captura o valor total autorizado por padrão. Para capturar um valor inferior ou (para alguns pagamentos com cartão online) superior ao valor inicial, passe a opção amount_to_capture. Uma captura parcial libera automaticamente o valor restante. Se tentar capturar mais do que o valor inicial de um pagamento online com cartão, consulte a documentação sobre captura a maior.

Veja este exemplo de como capturar US$ 7,50 de um pagamento autorizado de US$ 10,99:

curl https://api.stripe.com/v1/payment_intents/pi_123/capture \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount_to_capture=750

Embora alguns pagamentos com cartão sejam elegíveis para multicaptura, você só pode realizar uma captura em um pagamento autorizado para a maioria dos pagamentos. Se você capturar um pagamento parcial, não poderá fazer outra captura da diferença de valor. (Em vez disso, considere salvar os dados da forma de pagamento do cliente para usar depois e criar pagamentos futuros conforme necessário.)

Os extratos de alguns emissores e as interfaces de formas de pagamento nem sempre distinguem autorizações de pagamentos capturados (liquidados), o que pode confundir os clientes.

Além disso, quando um cliente finaliza o processo de pagamento em um PaymentIntent com captura manual, o evento payment_intent.amount_capturable_updated é acionado. Você pode inspecionar a propriedade amount_capturable do PaymentIntent para ver o valor total que pode ser capturado do PaymentIntent.

Cancelar a autorização

Para cancelar uma autorização, você pode cancelar o PaymentIntent.