Crea cargos directamente en la cuenta conectada y cobra una comisión.
Crea cargos directos cuando los clientes realicen la transacción directamente con una cuenta conectada, a menudo sin saber que existe tu plataforma. Con cargos directos:
El pago aparece como cargo en la cuenta conectada, no en la cuenta de tu plataforma.
El saldo de la cuenta conectada aumenta con cada pago.
El saldo de tu cuenta aumenta con las comisiones de la aplicación recibidas de cada pago.
Este tipo de cargo es el más adecuado para las plataformas que proporcionan software como servicio. Por ejemplo, Shopify proporciona herramientas para crear tiendas en línea, y Thinkific permite a quienes ofrecen cursos de educación venderlos en línea.
Una sesión de Checkout controla lo que tu cliente puede ver en el formulario de pago, como las partidas, el importe del pedido y la moneda. Agrega un botón de confirmación de compra a tu sitio web que llame a un punto de conexión del lado del servidor para crear una sesión de Checkout.
line_items: este atributo representa los artículos que está comprando tu cliente y aparece en la página de pago alojada por Stripe.
payment_intent_data[application_fee_amount]: este atributo especifica el importe que tu plataforma deduce de la transacción como comisión de la plataforma. Después de que se procesa el pago en la cuenta conectada, se transfiere el application_fee_amount a la plataforma. Consulta Cobra comisiones para obtener más información.
success_url - Stripe redirige al cliente a la URL de éxito después de que complete un pago y reemplaza la cadena {CHECKOUT_SESSION_ID} con la ID de la sesión de Checkout. Úsalo para recuperar la sesión de Checkout e inspecciona el estado para decidir qué mostrarás a tu cliente. También puedes adjuntar tus propios parámetros de consulta, que se mantendrán durante el proceso de redireccionamiento. Consulta la sección Personalizar el comportamiento de redireccionamiento en una página alojada en Stripe para obtener más información.
Stripe-Account: este encabezado indica un cargo directo para tu cuenta conectada. La imagen de marca de la cuenta conectada se utiliza en Checkout, lo que permite a tus clientes sentir que están interactuando directamente con la cuenta conectada en lugar de con tu plataforma. Consulta
Los cargos que crees directamente en la cuenta conectada se informan solo en esa cuenta. Estos cargos no aparecen en el Dashboard ni en las exportaciones de tu plataforma. Los cargos directos se incluyen en los informes y Sigma para las cuentas conectadas que controla tu plataforma. Siempre puedes recuperar esta información utilizando la API de Stripe.
Stripe envía un evento checkout.session.completed cuando se completa el pago. Utiliza un webhook para recibir estos eventos y ejecutar acciones, como enviar un correo electrónico de confirmación del pedido a tu cliente, registrar la venta en una base de datos o iniciar el flujo de tareas para un envío.
Escucha estos eventos en lugar de esperar una devolución de llamada del cliente. De su lado, el cliente puede cerrar la ventana del navegador o salir de la aplicación antes de que se ejecute la devolución de llamada. Además, algunos métodos de pago tardan entre 2 y 14 días en confirmar el pago. Si configuras tu integración para escuchar eventos asincrónicos, podrás aceptar varios métodos de pago con una sola integración.
Stripe recomienda administrar todos los siguientes eventos al cobrar pagos con Checkout:
Ponte en contacto con el cliente por correo electrónico y solicítale que haga un nuevo pedido.
Todos estos eventos incluyen el objeto Checkout Session. Después de que el pago se efectúa, el estado del PaymentIntent subyacente cambia de processing a succeeded o a un estado de falla.
Tu plataforma puede cobrar una comisión de la plataforma con las siguientes limitaciones:
El valor de application_fee_amount debe ser positivo e inferior al importe del cargo. El importe del cargo es el tope de la comisión de la plataforma que se puede cobrar.
No se aplican comisiones adicionales de Stripe a la comisión de la plataforma en sí.
En concordancia con los requisitos reglamentarios y de cumplimiento normativo de Brasil, las plataformas establecidas fuera de Brasil con cuentas conectadas brasileñas no pueden cobrar comisiones de la plataforma a través de Stripe.
La moneda de application_fee_amount depende de algunos factores de varias monedas.
La transacción de saldo del cargo resultante incluye un desglose detallado de las comisiones de Stripe y de la plataforma. Para brindar una mejor experiencia con los informes, se crea un objeto Application Fee después del cobro de la comisión. Usa la propiedad amount del objeto Application Fee para la elaboración de informes. Luego, puedes acceder a estos objetos usando el punto de conexión de comisiones de la plataforma.
Las comisiones ganadas se agregan al saldo disponible de tu cuenta según el mismo calendario que se aplica a los fondos provenientes de cargos normales de Stripe. Las comisiones de la aplicación se pueden ver en la sección Comisiones cobradas del Dashboard.
Precaución
De manera predeterminada, las comisiones de la aplicación para cargos directos se crean en forma asincrónica. Si expandes el objeto application_fee en una solicitud de creación de cargo, la tarifa de la aplicación se crea sincrónicamente como parte de esa solicitud. Solo amplía el objeto application_fee si es absolutamente necesario, ya que aumenta la latencia de la solicitud.
Para acceder a los objetos Application Fee por las comisiones de la aplicación que se crearon de forma asincrónica, escucha el evento de webhook application_fee.created
Flujo de fondos con comisiones
Cuando especificas una comisión de aplicación en un cargo, el monto de la comisión se transfiere a la cuenta de Stripe de tu plataforma. Al procesar un cargo directamente en la cuenta conectada, el monto del cargo, menos las comisiones de Stripe y la comisión de la aplicación, se deposita en la cuenta conectada.
Por ejemplo, si efectúas un cargo de USD 10 con una comisión de la aplicación de USD 1.23 (como en el ejemplo anterior), se transfieren USD 1.23 a la cuenta de la plataforma. La cuenta conectada obtiene un importe neto de USD 8.18 (USD 10 - USD 0.59 - USD 1.23) (con las comisiones estándar de Stripe en Estados Unidos).
Tu plataforma y las cuentas conectadas pueden usar la Configuración de imagen de marca en el Dashboard para personalizar la imagen de marca en la página de pagos. Para los cargos directos, Checkout utiliza la configuración de imagen de marca de la cuenta conectada.
También puedes usar la API para actualizar la configuración de imagen de marca:
icon: aparece junto al nombre de la empresa en el encabezado de la página de Checkout.
logo: se utiliza en lugar del ícono y el nombre de la empresa en el encabezado de la página de Checkout.
primary_color: se utiliza como color de fondo en la página de Checkout.
secondary_color: se utiliza como color del botón en la página de Checkout.
De la misma manera que las plataformas pueden crear cargos en las cuentas conectadas, también pueden crear reembolsos de cargos en las cuentas conectadas. Crea un reembolso con la clave secreta de tu plataforma estando autenticado como cuenta conectada.
Las comisiones de la aplicación no se reembolsan automáticamente al emitir el reembolso. Tu plataforma debe reembolsar expresamente la comisión de la aplicación, o la cuenta conectada (la cuenta en la que se creó el cargo) perderá ese importe. Puedes reembolsar la comisión de la aplicación pasando el valor refund_application_fee de true en la solicitud de reembolso:
De forma predeterminada, se reembolsa el total del cargo, pero puedes crear un reembolso parcial estableciendo un valor de amount como un número entero positivo. Si el reembolso implica que se reembolsa el total del cargo, se reembolsa el total de la comisión de la plataforma. De lo contrario, se reembolsa un importe proporcional de la comisión de la plataforma. Como alternativa, puedes proporcionar un valor de refund_application_fee de false y reembolsar la comisión de la plataforma por separado.
Welcome to the Stripe Shell!
Stripe Shell is a browser-based shell with the Stripe CLI pre-installed. Log in to your
Stripe account and press Control + Backtick (`) on your keyboard to start managing your Stripe
resources in test mode.
- View supported Stripe commands:
- Find webhook events:
- Listen for webhook events:
- Call Stripe APIs: stripe [api resource] [operation] (e.g., )
Stripe Shell funciona mejor en una computadora de escritorio.