Retener fondos de un método de pago

Cuando creas un pago, puedes retener un método de pago que cumpla los requisitos para reservar fondos que puedas capturar más tarde. Por ejemplo, los hoteles a menudo autorizan el pago completo antes de que llegue el huésped y luego capturan el dinero cuando el huésped se va del hotel. Esto a veces se denomina captura manual.

La autorización de un pago garantiza el importe reteniéndolo en el método de pago del cliente. Si estás usando la API, el atributo payment_method_details.card.capture_before en el cargo indica cuándo caduca la autorización.

Debes capturar los fondos antes de que caduque la autorización. Si la autorización vence antes de capturar los fondos, estos se liberan y el estado del pago cambia a canceled. Obtén más información sobre los estados de los pagos asíncronos.

Plazos de validez de las autorizaciones

En las siguientes tablas se describen los intervalos de validez para autorizar diferentes tipos de transacciones.

Transacciones con tarjeta no presente

Transacciones con tarjeta presente (pagos en persona)

Plazos de autorización de 30 días en Japón

Si tu cuenta está establecida en Japón, puedes retener transacciones en JPY de Visa, Mastercard, JCB, Diners Club y Discover durante un máximo de 30 días. Las transacciones que no sean JPY y American Express vencen después del plazo estándar de 7 días.

Limitaciones de los métodos de pago

Antes de la implementación, debes comprender las siguientes limitaciones para autorizar y capturar por separado.

• Solo algunos métodos de pago admiten la captura y la autorización por separado. Algunos métodos de pago compatibles incluyen tarjetas, Affirm, Afterpay, Cash App Pay, Klarna y PayPal. Algunos métodos de pago que no son compatibles son ACH e iDEAL. Obtén más información sobre la compatibilidad de funciones de métodos de pago.

• Aparte de lo que se describe en las tablas anteriores, otros métodos de pago tienen diferentes reglas y plazos de autorización:

  • Pagos con tarjeta: El importe suele estar retenido durante 7 días para los pagos en línea y 2 días para los pagos en persona con Terminal (según el tipo de transacción y la red de tarjetas). Puedes solicitar una autorización ampliada para determinadas autorizaciones de pago en línea y de Terminal que cumplen los requisitos para ampliar los períodos de validez. Las redes de tarjetas también pueden restringir autorizaciones de 1 USD que no tengas intención de capturar.
  • Affirm: Si Affirm requiere un pago inicial para pedidos de importes muy elevados, cobrará el importe durante la autorización y el reembolso si el pago no se captura. A continuación, tienes 30 días para capturar el saldo del pago.
  • Afterpay/Clearpay: Durante la autorización, el cliente paga la primera cuota de devolución. Afterpay reembolsa el pago si nunca se captura. A continuación, tienes 13 días para capturar el saldo del pago.
  • Cash App Pay: las autorizaciones válidas deben capturarse en un plazo de 7 días para completar un pago.
  • Klarna: debes capturar el cargo antes de la medianoche del día 28 natural después de la solicitud de cargo; de lo contrario, la autorización caducará. Por ejemplo, tendrías que capturar una solicitud de cargo el 1 de octubre de 2020 a las 14:00 horas UTC para el 29 de octubre de 2020 a las 00:00 horas UTC.
  • PayPal: retiene el importe durante 10 días. Stripe intenta automáticamente extender la retención por otros 10 días, hasta un total de 20 días. Tu preferencia de cobro puede afectar al período de autorización. Para obtener más información, consulta separar la autorización y la captura.

Utilizar el Dashboard para autorizar y capturar

Puedes autorizar un pago y capturar fondos por separado sin escribir código.

1. En el Dashboard, crea un nuevo pago. Selecciona Único.
2. Cuando introduzcas o selecciones el método de pago, selecciona Más opciones y luego Capturar fondos más tarde.

El pago aparece en tu página de pagos como No capturado.

Para capturar los fondos, dirígete a la página de datos de pago y haz clic en Capturar.

Indicarle a Stripe que autorice solamente

Para indicar que quieres separar la autorización y la captura, especifica capture_method en manual al crear el PaymentIntent. Este parámetro le indica a Stripe que debe autorizar el importe, pero no capturarlo en el método de pago del 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

Con el enfoque anterior, le dices a Stripe que solo puedes usar “capturar después de” para un PaymentIntent con métodos de pago elegibles. Por ejemplo, no puedes aceptar pagos con tarjeta y adeudo directo SEPA (que no admite la captura posterior) para un solo PaymentIntent. Para aceptar métodos de pago en los que es posible que no todos admitan la captura después, puedes configurar capture-after-per-payment-method configurando capture_method=manual en el objeto payment_method_options[<payment_method_type>].

Por ejemplo, al configurar payment_method_options[card][capture_method]=manual, solo pondrás en espera los pagos con tarjeta. Puedes gestionar los métodos de pago desde el Dashboard. Stripe gestiona la lógica para mostrar dinámicamente los métodos de pago que cumplen los requisitos más relevantes para cada cliente en función de factores como el importe de la transacción, la divisa y el flujo de pagos.

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

Como otra opción, puedes enumerar card y sepa_debit usando tipos de métodos de pago como en el siguiente ejemplo.

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 con la captura, adjunta un método de pago con los datos de la tarjeta al PaymentIntent y autoriza la tarjeta confirmando el PaymentIntent. Puedes hacerlo estableciendo los campos payment_method y confirm en el PaymentIntent.

Capturar los fondos

Una vez autorizado el método de pago, el estado del PaymentIntent pasa a requires_capture. Para capturar los fondos autorizados, realiza una solicitud de captura de PaymentIntent. Esto captura el importe total autorizado de forma predeterminada. Para capturar menos o (para ciertos pagos con tarjeta en línea) más que el importe inicial, especifica la opción amount_to_capture. Una captura parcial libera automáticamente el importe restante. Si intentas capturar un importe superior al inicial para un pago con tarjeta en línea, consulta la documentación de sobrecaptura.

El siguiente ejemplo muestra cómo capturar 7,50 USD del pago autorizado de 10,99 USD:

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

Si bien algunos pagos con tarjeta cumplen los requisitos para la captura múltiple, para la mayoría de los pagos, en un pago autorizado solo se puede realizar una captura. Si capturas parte de un pago, no podrás hacer otra captura por la diferencia. (Como alternativa, considera guardar los datos del método de pago del cliente para más tarde y crear pagos futuros según sea necesario).

Los extractos de tarjetas de algunos emisores y las interfaces de métodos de pago no siempre distinguen entre autorizaciones y pagos capturados (liquidados), lo que en ocasiones puede resultar confuso para el cliente.

Además, cuando un cliente completa el proceso de pago en un PaymentIntent con captura manual, se activa el evento payment_intent.amount_capturable_updated. Puedes inspeccionar la propiedad amount_capturable del PaymentIntent para ver el importe total que puedes capturar del PaymentIntent.

Cancelar la autorización

Si necesitas cancelar una autorización, puedes cancelar el PaymentIntent.