Cómo retener fondos en una tarjetaAPI Charges
API heredada
El contenido de esta sección se refiere a una funcionalidad Heredada. En su lugar, usa la API Payment Intents.
The Charges API doesn’t support the following features, many of which are required for credit card compliance:
Usa la API Charges para autorizar un pago ahora y capturar los fondos más tarde.
Precaución
Desde septiembre de 2019, una reglamentación denominada Autenticación reforzada de clientes (SCA) les exige a las empresas de Europa solicitar una autenticación adicional en los pagos electrónicos. Las empresas establecidas en el Espacio Económico Europeo (EEE) con clientes en el EEE deben seguir la guía sobre cómo aceptar un pago para utilizar la API Payment Intents a fin de cumplir con la normativa.
Stripe admite los pagos con tarjeta en dos pasos, de modo que primero puedes autorizar un cargo y luego esperar a que se acredite (capture) más tarde. Cuando se autoriza un cargo, el emisor de la tarjeta garantiza los fondos y retiene el importe en la tarjeta del cliente generalmente por up to 7 days, or 2 days for in-person payments using Terminal. El atributo payment_method_details.card.capture_before en el cargo indica el momento en el que vence la autorización.
Si el cargo no se captura dentro de este período, la autorización se cancela y los fondos se liberan.
Autorizar un pago
Para autorizar un pago sin capturarlo, haz una solicitud de cargo que también incluya el parámetro capture establecido en falso. Esto le indica a Stripe que solo debe autorizar el importe en la tarjeta del cliente.
Precaución
Solo algunos métodos de pago aceptan la captura y la autorización por separado. Por ejemplo, los pagos con tarjetas, Afterpay y Klarna admiten realizar estos pasos por separado. Con los métodos de pago que no aceptan esta funcionalidad, como ACH o iDEAL, la captura no se puede hacer manualmente. Consulta la lista completa de métodos de pago que aceptan la captura manual.
Si necesitas cancelar una autorización, puedes liberarla rembolsando el objeto Charge correspondiente.
Capturar los fondos
Para acreditar un cargo autorizado, solicita la captura del cargo. De forma predeterminada, se captura el importe total autorizado; no puedes capturar más que ese importe. Para capturar un importe inferior al importe inicial (por ejemplo, USD 8 de una autorización de USD 10), especifica el parámetro amount. La captura de una parte del cargo libera automáticamente el importe restante.
Los extractos de tarjetas de algunos emisores no distinguen entre autorizaciones y cargos capturados (acreditados), lo cual puede resultar confuso para el cliente. Además, los cargos autorizados solo pueden capturarse una vez. Si capturas parte del cargo, no podrás hacer otra captura por la diferencia. En función de lo que necesites, puede que te resulte mejor guardar los datos de la tarjeta del cliente para más tarde y crear cargos según sea necesario.