Ir a contenido
Crea una cuenta
o
Inicia sesión
Logotipo de Stripe Docs
/
Pregúntale a la IA
Crear una cuenta
Iniciar sesión
Empieza ahora
Pagos
Ingresos
Plataformas y marketplaces
Gestión del dinero
Herramientas para desarrolladores
Resumen
Empieza a usar Connect
Fundamentos de la integración
Ejemplos de integraciones
Haz el onboarding de las cuentas
Configura los Dashboards de la cuenta
Aceptar pagos
    Crear un cargo
      Cargos Direct
      Cargos a un Destino
      Cargos y envíos de fondos separados
    Definir descripciones de los cargos en el extracto bancario
    Configurar códigos de categoría de comercio
    Administrar varias monedas
    Crea enlaces de pago con Connect
    Usa Radar con Connect
    Disputas en Connect
    Crea suscripciones
    Crear facturas
    Configuraciones de varios métodos de pago
    Integra el componente de configuración del método de pago
    Saldo de la cuenta
Transfiere a cuentas
Gestiona tu plataforma Connect
Formularios fiscales para tu plataforma Connect
Trabaja con tipos de cuentas conectadas
InicioPlataformas y marketplacesAccept paymentsCreate a charge

Crea cargos y envíos de fondos separados

Crea cargos en la cuenta de tu plataforma y transfiere fondos a varias cuentas conectadas.

Copiar página

Crea cargos y envíos de fondos separados para transferir fondos de un pago a varias cuentas conectadas, o cuando no se conozca a un usuario específico en el momento del pago. El cargo en la cuenta de tu plataforma se desasocia de las transferencias a tus cuentas conectadas. Con este tipo de cargo, puedes hacer lo siguiente:

  • Creas un cargo en la cuenta de tu plataforma y también transfieres fondos a tus cuentas conectadas. El pago aparece como un cargo en tu cuenta y también hay transferencias a cuentas conectadas (por un importe determinado por ti), que se extraen del saldo de tu cuenta.
  • Puedes transferir fondos a varias cuentas conectadas.
  • Se debita del saldo de tu cuenta el costo de las comisiones, los reembolsos y los contracargos de Stripe.

Este tipo de cargo es óptimo para los marketplaces que tienen que dividir los pagos entre varias partes, por ejemplo DoorDash, que es una plataforma de entrega para restaurantes.

Stripe acepta cargos y transferencias separados en las siguientes regiones:

Alemania
Australia
Austria
Bélgica
Brasil
Bulgaria
Canadá
Chipre
Croacia
Dinamarca
Eslovaquia
Eslovenia
España
Estados Unidos
Estonia
Finlandia
Francia
Grecia
Hungría
Irlanda
Italia
Japón
Letonia
Liechtenstein
Lituania
Luxemburgo
Malasia
Malta
México
Noruega
Nueva Zelanda
Países Bajos
Polonia
Portugal
Reino Unido
República Checa
Rumania
Singapur
Suecia
Suiza

En la mayoría de los casos, tu plataforma y todas las cuentas conectadas deben ser de la misma región. Si intentas transferir fondos a través de una frontera no permitida, se producirá un error. Para obtener información sobre el soporte entre regiones, consulta transferencias transfronterizas. Debes usar los envíos de fondos únicamente en combinación con los casos de uso permitidos para cargos, recargas y comisiones. Recomendamos usar cargos y envíos de fondos separados para las cuentas conectadas que tienen acceso al Dashboard de Express o que no tienen acceso al Dashboard.

Vista previa privada

Puedes usar cargos a un destino, sin el parámetro on_behalf_of, cuando tu plataforma y la cuenta conectada estén en diferentes países de EE. UU., el Reino Unido y la Unión Europea. Para acceso anticipado, comunícate con us.

Para crear una integración de pagos personalizada, integra componentes de interfaz de usuario (IU) en tu sitio con Stripe Elements. El código del lado del cliente y del lado del servidor crea un formulario de confirmación de compra que acepta varios métodos de pago. Comprueba cómo esta integración se compara con los otros tipos de integración de Stripe.

Ubicación del cliente
Tamaño
Tema
Disposición
Para ver cómo funciona Link en un usuario que regresa, introduce el correo electrónico demo@stripe.com. Para ver cómo funciona Link cuando se crea una cuenta nueva, introduce cualquier otro correo electrónico y completa el resto del formulario. En esta demostración, solo se muestra Google Pay o Apple Pay si tienes una tarjeta activa con cualquiera de las billeteras.

Esfuerzo de integración

Mismo código

Tipo de integración

Combina componentes de la interfaz de usuario en un flujo de pago personalizado

Personalización de la interfaz de usuario

Personalización a nivel CSS con la API Appearance

Primero, inscríbete para obtener una cuenta de Stripe.

Usa nuestras bibliotecas oficiales para acceder a la API de Stripe desde tu aplicación:

Command Line
Ruby
# Available as a gem sudo gem install stripe
Gemfile
Ruby
# If you use bundler, you can add this line to your Gemfile gem 'stripe'

Crear un PaymentIntent
Lado del servidor

Stripe usa un objeto PaymentIntent para representar tu intención de cobrar a un cliente y hace el seguimiento de los intentos de cobro y de los cambios en el estado del pago en todo el proceso.

Los métodos de pago que se muestran a los clientes durante el proceso de finalización de compra también se incluyen en el PaymentIntent. Puedes permitir que Stripe extraiga automáticamente los métodos de pago desde la configuración de tu Dashboard o puedes enumerarlos manualmente.

A menos que tu integración requiera una opción basada en código para ofrecer métodos de pago, no los enumeres manualmente. Stripe evalúa la moneda, las restricciones de los métodos de pago y otros parámetros para determinar la lista de métodos de pago admitidos. Stripe prioriza los métodos de pago que aumentan la conversión y guardan mayor relación con la moneda y la ubicación del cliente. Stripe oculta los métodos de pago menos prioritarios en un menú de contenido adicional.

Crea una PaymentIntent en tu servidor con un importe, una moneda y un valor transfer_group para asociar con el envío de fondos más adelante. En la última versión de la API, especificar el parámetro automatic_payment_methods es opcional porque Stripe habilita su funcionalidad de forma predeterminada. Puedes gestionar los métodos de pago desde el Dashboard. Stripe gestiona las devoluciones de los métodos de pago que cumplen los requisitos en función de factores como el importe de la transacción, la moneda y el flujo de pagos.

Command Line
cURL
curl https://api.stripe.com/v1/payment_intents \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -d amount=10000 \ -d currency=usd \ -d "automatic_payment_methods[enabled]"=true \ -d transfer_group=ORDER100

Recuperar el secreto de cliente

El PaymentIntent incluye un secreto de cliente que el lado del cliente usa para completar el proceso de pago de forma segura. Puedes usar diferentes métodos para pasar el secreto del cliente al lado del cliente.

Recupera el secreto de cliente de un punto de conexión de tu servidor con la funcionalidad fetch del navegador. Este método es más conveniente si tu lado del cliente es una aplicación de una sola página, especialmente, si fue diseñada con un marco de front-end moderno como React. Crea el punto de conexión del servidor que se usa para el secreto de cliente:

main.rb
Ruby
get '/secret' do intent = # ... Create or retrieve the PaymentIntent {client_secret: intent.client_secret}.to_json end

Luego recupera el secreto de cliente con JavaScript del lado del cliente:

(async () => { const response = await fetch('/secret'); const {client_secret: clientSecret} = await response.json(); // Render the form using the clientSecret })();

Recopilar datos de pago
Lado del cliente

Recopila los datos de pago del cliente con el Payment Element. Payment Element es un componente de interfaz de usuario prediseñado que simplifica la recopilación de datos de pago para una variedad de métodos de pago.

El Payment Element contiene un iframe que envía la información de pago a Stripe de manera segura a través de una conexión HTTPS. Evita colocar el Payment Element dentro de otro iframe porque algunos métodos de pago requieren redirigir a otra página para la confirmación del pago.

Si eliges usar un iframe y quieres aceptar Apple Pay o Google Pay, el iframe debe tener el atributo permitir definido en igual a "payment *"

Para que la integración funcione, la dirección de la página de finalización de compra debe empezar con https:// en lugar de http://. Puedes probar tu integración sin usar HTTPS, pero recuerda habilitarla cuando estés listo para aceptar pagos reales.

Configurar Stripe.js

El Payment Element se encuentra disponible automáticamente como funcionalidad de Stripe.js. Incluye el script de Stripe.js en tu página de finalización de compra agregándolo al head de tu archivo HTML. Siempre debes cargar Stripe.js directamente desde js.stripe.com para cumplir con la normativa PCI. No incluyas el script en un paquete ni alojes una copia en tus sistemas.

checkout.html
<head> <title>Checkout</title> <script src="https://js.stripe.com/v3/"></script> </head>

Crea una instancia de Stripe con el siguiente código JavaScript en tu página de pago:

checkout.js
// Set your publishable key: remember to change this to your live publishable key in production // See your keys here: https://dashboard.stripe.com/apikeys const stripe = Stripe(
'pk_test_TYooMQauvdEDq54NiTphI7jx'
);

Agrega el Payment Element a tu página de pago

El Payment Element necesita un lugar específico en tu página de pago. Crea un nodo DOM vacío (contenedor) con un ID único en tu formulario de pago:

checkout.html
<form id="payment-form"> <div id="payment-element"> <!-- Elements will create form elements here --> </div> <button id="submit">Submit</button> <div id="error-message"> <!-- Display error message to your customers here --> </div> </form>

Cuando se cargue el formulario anterior, crea una instancia de Payment Element y móntala en el nodo DOM del contenedor. Especifica el secreto de cliente del paso anterior en options cuando crees la instancia Elements:

Debes administrar el secreto de cliente con cuidado porque sirve para completar el cargo. No lo registres, no lo insertes en direcciones URL ni lo expongas a nadie que no sea el cliente.

checkout.js
const options = { clientSecret: '{{CLIENT_SECRET}}', // Fully customizable with appearance API. appearance: {/*...*/}, }; // Set up Stripe.js and Elements to use in checkout form, passing the client secret obtained in a previous step const elements = stripe.elements(options); // Create and mount the Payment Element const paymentElementOptions = { layout: 'accordion'}; const paymentElement = elements.create('payment', paymentElementOptions); paymentElement.mount('#payment-element');

Explora Stripe Elements

Stripe Elements es una colección de componentes de interfaz de usuario (IU) desplegables. Para personalizar aún más tu formulario o recopilar otra información del cliente, consulta la documentación de Elements.

El Payment Element renderiza un formulario dinámico que le permite a tu cliente elegir un método de pago. Para cada método de pago, el formulario le pide automáticamente al cliente que complete todos los datos de pago necesarios.

Personaliza el aspecto

Personaliza el Payment Element para que coincida con el diseño de tu sitio especificando el objeto appearance en options al crear el proveedor Elements.

Recopila las direcciones

De forma predeterminada, el Payment Element solo recopila los datos necesarios de la dirección de facturación. Para recopilar la dirección de facturación completa de un cliente (por ejemplo, para calcular el impuesto sobre bienes y servicios digitales) o la dirección de envío, usa el Address Element.

Solicita un token de comerciante de Apple Pay

Si configuraste tu integración para aceptar pagos de Apple Pay, te recomendamos que configures la interfaz de Apple Pay para devolver un token de comerciante a fin de habilitar las transacciones iniciadas por el comerciante (MIT). Solicita el tipo de token de comerciante correspondiente en el Payment Element.

Enviar el pago a Stripe
Lado del cliente

Usa stripe.confirmPayment para completar el pago con los datos del Payment Element. Proporciona una return_url a esta función para indicar a dónde Stripe debe redirigir al usuario después de completar el pago. Es posible que primero se redirija al usuario a un sitio intermedio, como una página de autorización del banco y, luego, a lareturn_url. Los pagos con tarjeta redirigen inmediatamente a la return_url cuando un pago se realiza correctamente.

Si no quieres realizar el redireccionamiento de pagos con tarjeta una vez que se completan los pagos, puedes configurar el redireccionamiento en if_required. Esto solo redirigirá a los clientes que finalizan su compra con métodos de pago basados en redireccionamiento.

checkout.js
const form = document.getElementById('payment-form'); form.addEventListener('submit', async (event) => { event.preventDefault(); const {error} = await stripe.confirmPayment({ //`Elements` instance that was used to create the Payment Element elements, confirmParams: { return_url: 'https://example.com/order/123/complete', }, }); if (error) { // This point will only be reached if there is an immediate error when // confirming the payment. Show error to your customer (for example, payment // details incomplete) const messageContainer = document.querySelector('#error-message'); messageContainer.textContent = error.message; } else { // Your customer will be redirected to your `return_url`. For some payment // methods like iDEAL, your customer will be redirected to an intermediate // site first to authorize the payment, then redirected to the `return_url`. } });

Asegúrate de que la return_url corresponda a una página de tu sitio web que proporcione el estado del pago. Cuando Stripe redirige al cliente a la return_url, proporcionamos los siguientes parámetros de consulta de URL:

ParámetroDescripción
payment_intentEl identificador único del PaymentIntent.
payment_intent_client_secretEl secreto de cliente del objeto PaymentIntent.

Precaución

Si tienes herramientas que rastrean la sesión del navegador del cliente, es posible que debas agregar el dominio stripe.com a la lista de exclusión de referentes. Los redireccionamientos hacen que algunas herramientas creen nuevas sesiones, lo que te impide realizar un seguimiento de la sesión completa.

Usa uno de los parámetros de consulta para recuperar el PaymentIntent. Examina el estado del PaymentIntent para decidir qué mostrarás a tus clientes. También puedes adjuntar tus propios parámetros de consulta cuando proporciones la return_url, que se mantendrán durante el proceso de redireccionamiento.

status.js
// Initialize Stripe.js using your publishable key const stripe = Stripe(
'pk_test_TYooMQauvdEDq54NiTphI7jx'
); // Retrieve the "payment_intent_client_secret" query parameter appended to // your return_url by Stripe.js const clientSecret = new URLSearchParams(window.location.search).get( 'payment_intent_client_secret' ); // Retrieve the PaymentIntent stripe.retrievePaymentIntent(clientSecret).then(({paymentIntent}) => { const message = document.querySelector('#message') // Inspect the PaymentIntent `status` to indicate the status of the payment // to your customer. // // Some payment methods will [immediately succeed or fail][0] upon // confirmation, while others will first enter a `processing` state. // // [0]: https://stripe.com/docs/payments/payment-methods#payment-notification switch (paymentIntent.status) { case 'succeeded': message.innerText = 'Success! Payment received.'; break; case 'processing': message.innerText = "Payment processing. We'll update you when payment is received."; break; case 'requires_payment_method': message.innerText = 'Payment failed. Please try another payment method.'; // Redirect your user back to your payment page to attempt collecting // payment again break; default: message.innerText = 'Something went wrong.'; break; } });

Administrar eventos posteriores al pago
Lado del servidor

Stripe envía un evento payment_intent.succeeded cuando se completa el pago. Usa la herramienta de webhook del Dashboard o sigue la guía de webhooks para recibir estos eventos y ejecutar acciones como, por ejemplo, enviar un correo electrónico de confirmación del pedido a tu cliente, registrar la venta en una base de datos o iniciar un flujo de envío.

Listen for these events rather than waiting on a callback from the client. On the client, the customer could close the browser window or quit the app before the callback executes, and malicious clients could manipulate the response. Setting up your integration to listen for asynchronous events is what enables you to accept different types of payment methods with a single integration.

Además de administrar el evento payment_intent.succeeded, recomendamos administrar estos otros eventos si se cobran pagos con el Payment Element:

EventoDescripciónAcción
payment_intent.succeededSe envía cuando un cliente completa correctamente un pago.Envía al cliente una confirmación del pedido y completa el pedido.
payment_intent.processingSe envía cuando un cliente inicia con éxito un pago, pero éste aún no se completó. Este evento se envía normalmente cuando el cliente inicia un débito bancario. Le sigue un evento payment_intent.succeeded o payment_intent.payment_failed en el futuro.Envía al cliente una confirmación del pedido que indique que el pago está pendiente. En caso de productos digitales, quizá te convenga completar el pedido antes de esperar que se complete el pago.
payment_intent.payment_failedEnviado cuando un cliente intenta un pago, pero el pago falla.Si un pago pasa de processing a payment_failed, ofrécele al cliente otro intento de pago.

Crear un envío de fondos
Lado del servidor

En tu servidor, envía fondos desde tu cuenta a una cuenta conectada creando un envío de fondos y especificando el transfer_group utilizado.

Command Line
cURL
curl https://api.stripe.com/v1/transfers \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -d amount=7000 \ -d currency=usd \ -d destination=
{{CONNECTED_ACCOUNT_ID}}
\ -d transfer_group=ORDER100

Los importes de transferencia y cargo no tienen que coincidir. Puedes dividir un solo cargo entre varias transferencias o incluir varios cargos en una sola transferencia. En el siguiente ejemplo se crea una transferencia adicional asociada con el mismo transfer_group.

Command Line
cURL
curl https://api.stripe.com/v1/transfers \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -d amount=2000 \ -d currency=usd \ -d destination={{OTHER_CONNECTED_ACCOUNT_ID}} \ -d transfer_group=ORDER100

Opciones de envíos de fondo

Puedes asignar cualquier valor a la cadena transfer_group, pero debes representar una sola acción comercial. También puedes realizar una transferencia sin un cargo asociado ni un transfer_group, por ejemplo, cuando debes pagar a un proveedor pero no hay un pago de cliente asociado.

Nota

El transfer_group solo identifica los objetos asociados. No afecta a ninguna funcionalidad estándar. Para evitar que se ejecute una transferencia antes de que estén disponibles los fondos del cargo asociado, usa el atributo source_transaction de la transferencia.

De forma predeterminada, una solicitud de envío de fondos falla cuando el monto excede el saldo disponible de la cuenta de la plataforma Stripe no reintenta automáticamente las solicitudes de envío de fondos fallidas.

Puedes evitar que se produzcan errores en las solicitudes de envío de fondos asociados a cargos. Cuando especificas el cargo asociado como source_transaction del envío de fondos, la solicitud de envío de fondos se efectúa automáticamente. Sin embargo, no ejecutamos dicho envío hasta que los fondos de ese cargo estén disponibles en la cuenta de la plataforma.

Nota

Si utilizas cargos y envíos de fondos separados, tenlo en cuenta al planificar tu calendario de transferencias. Las transferencias automáticas pueden interferir con las transferencias que no tienen una source_transaction definida.

Probar la integración

Número de tarjetaEscenarioCómo hacer la prueba
El pago con tarjeta se efectúa correctamente y no requiere autenticación.Completa el formulario de tarjeta de crédito con el número de tarjeta de crédito y la fecha de vencimiento, el CVC o el código postal.
El pago con tarjeta requiere autenticación.Completa el formulario de tarjeta de crédito con el número de tarjeta de crédito y la fecha de vencimiento, el CVC o el código postal.
La tarjeta es rechazada con un código de rechazo insufficient_funds.Completa el formulario de tarjeta de crédito con el número de tarjeta de crédito y la fecha de vencimiento, el CVC o el código postal.
La tarjeta UnionPay puede tener entre 13 y 19 dígitos.Completa el formulario de tarjeta de crédito con el número de tarjeta de crédito y la fecha de vencimiento, el CVC o el código postal.

Consulta Pruebas para obtener información adicional para probar tu integración.

OpcionalHabilita métodos de pago adicionales

Especifica el comerciante a cargo del cobro

El comerciante a cargo del cobro depende de las funcionalidades activas en una cuenta y de cómo se crea el cargo. El comerciante a cargo del cobro determina de quién es la información utilizada para efectuar el cargo. Esto incluye la descripción del cargo (ya sea de la plataforma o de la cuenta conectada) que aparecerá para ese cargo en el extracto bancario o de tarjeta de crédito del cliente.

Si especificas el comerciante a cargo del cobro, puedes ser más explícito sobre quién es el destinatario del cargo. Por ejemplo, algunas plataformas prefieren ser el comerciante a cargo del cobro porque el usuario final interactúa directamente con ellas, como es el caso de las plataformas on-demand. No obstante, algunas plataformas tienen cuentas conectadas que interactúan directamente con los consumidores finales (por ejemplo, las tiendas físicas de una plataforma de e-commerce). En estos casos, es más lógico que el comerciante a cargo del cobro sea la cuenta conectada.

Puedes establecer el parámetro on_behalf_of en el ID de una cuenta conectada para que esa cuenta sea el comerciante a cargo del cobro. Cuando se usa on_behalf_of:

  • Los cargos se liquidan en el país y la moneda de cobro de la cuenta conectada.
  • Se utiliza la estructura de comisiones del país de la cuenta conectada.
  • La descripción del cargo en el extracto bancario de la cuenta conectada se muestra en el extracto de la tarjeta de crédito del cliente.
  • Si la cuenta conectada está en un país diferente al de la plataforma, la dirección y el número de teléfono de la cuenta conectada se muestran en el extracto de la tarjeta de crédito del cliente.
  • La cantidad de días durante la que se retiene el saldo pendiente antes de pagar depende de la configuración del delay_days en la cuenta conectada.

Si se omite on_behalf_of, la plataforma es la empresa registrada para el pago.

Precaución

El parámetro on_behalf_of solo se admite para cuentas conectadas con una funcionalidad de pagos como card_payments. Las cuentas regidas por el Contrato de servicios del destinatario no pueden solicitar card_payments u otras funcionalidades de pago.

Command Line
cURL
curl https://api.stripe.com/v1/payment_intents \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -d amount=10000 \ -d currency=usd \ -d "automatic_payment_methods[enabled]"=true \ -d on_behalf_of=
{{CONNECTED_ACCOUNT_ID}}
\ -d transfer_group=ORDER100

Cobra comisiones

Cuando se utilizan cargos y transferencias separados, la plataforma puede cobrar comisiones sobre un cargo al reducir la cantidad que transfiere a las cuentas de destino. Por ejemplo, considera una transacción de servicio de entrega a domicilio en un restaurante que implique pagos al restaurante y al socio de la App:

  1. El cliente paga un cargo de 100 USD.
  2. Stripe cobra una comisión de 3.20 USD y agrega los 96.80 USD restantes al saldo pendiente de la cuenta de la plataforma.
  3. La plataforma transfiere 70 USD a la cuenta conectada del restaurante y 20 USD a la cuenta conectada del conductor.
  4. Una comisión de plataforma de 6.80 USD permanece en la cuenta de la plataforma.
Cómo se divide un cargo en comisiones para la cuenta de la plataforma y transferencias para las cuentas conectadas

Para obtener información sobre cómo procesar pagos en múltiples monedas con Connect, consulta cómo trabajar con múltiples monedas.

Disponibilidad de los envíos de fondos

El comportamiento predeterminado es transferir fondos desde el saldo disponible de la cuenta de la plataforma. Si intentas transferir un monto que exceda el saldo disponible, falla y aparece un mensaje de error. Para evitar este problema, al crear una transferencia, vincula la partida a un cargo existente especificando el ID del cargo como parámetro source_transaction. Con un source_transaction, la solicitud de transferencia devuelve el saldo correcto independientemente de tu saldo disponible si el cargo relacionado aún no se ha acreditado. Sin embargo, los fondos no estarán disponibles en la cuenta de destino hasta que los fondos del cargo asociado estén disponibles para transferirlos desde la cuenta de la plataforma.

Nota

Si una transferencia falla debido a que el dinero en el saldo de tu plataforma no es suficiente, el hecho de agregar fondos no provocará automáticamente que se vuelva a intentar la acción fallida. Después de agregar fondos, debes repetir el envío o la transferencia que falló.

Si el cargo de origen tiene un valor transfer_group, Stripe asigna el mismo valor al transfer_group de la transferencia. De no ser así, Stripe genera una cadena con el formato group_ más el ID del PaymentIntent asociado, por ejemplo: group_pi_2NHDDD589O8KAxCG0179Du2s. Asigna esa cadena como el transfer_group tanto para el cargo como para la transferencia.

Nota

Debes especificar el source_transaction al crear un envío de fondos. No puedes actualizar ese atributo más adelante.

Command Line
cURL
curl https://api.stripe.com/v1/transfers \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -d amount=7000 \ -d currency=usd \ -d source_transaction=
{{CHARGE_ID}}
\ -d destination=
{{CONNECTED_ACCOUNT_ID}}

Puedes obtener la identificación del cargo del PaymentIntent:

  • Obtén el atributo latest_charge del PaymentIntent. Este atributo es el ID del cargo más reciente asociado al PaymentIntent.
  • Solicita una lista de cargos, donde se especifique el payment_intent en la solicitud. Este método devuelve los datos completos de todos los cargos asociados con el PaymentIntent.

Cuando se usa este parámetro:

  • El importe del envío de fondos no debe superar el importe del cargo de origen
  • Puedes crear varios envíos de fondos con la misma source_transaction siempre que la suma de los envíos no supere el cargo de origen
  • El envío de fondos asume el estado pendiente del cargo asociado, es decir, si los fondos del cargo están disponibles en N días, el pago recibido a través del envío de fondos por la cuenta de Stripe de destino también estará disponible en N días.
  • Stripe crea automáticamente un transfer_group para ti
  • La moneda de la transacción de saldo asociada con el cargo debe coincidir con la moneda de la transferencia

Los métodos de pago asincrónicos, como ACH, pueden fallar después de realizar una solicitud de envío de fondos posterior. Para estos pagos, evita usar source_transaction. En su lugar, espera a que se active un evento charge.succeeded antes de transferir los fondos. Si tienes que usar source_transaction con estos pagos, debes implementar una funcionalidad para gestionar los errores de pagos.

Cuando falla un pago utilizado como source_transaction, se transfieren fondos del saldo de la cuenta de tu plataforma a la cuenta conectada para cubrir el pago. Para recuperar estos fondos, revierte la transferencia asociada con el source_transaction fallido.

Emite reembolsos

Puedes reembolsar cargos creados en tu plataforma usando su clave secreta. Sin embargo, el reembolso de un cargo no influye en ningún envío de fondos asociado. Tu plataforma es la que debe conciliar los importes adeudados reduciendo los importes de los envíos de fondos posteriores o revirtiendo los envíos de fondos.

Command Line
cURL
curl https://api.stripe.com/v1/refunds \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -d charge=
{{CHARGE_ID}}

Revertir envíos de fondos

Connect admite la posibilidad de revertir transferencias efectuadas a cuentas conectadas, ya sea en parte o en su totalidad (estableciendo un valor para amount). Usa las revocaciones de envíos de fondos solo para reembolsos o disputas relacionadas con el cargo, o para corregir errores en el envío de fondos.

Command Line
cURL
curl https://api.stripe.com/v1/transfers/
{{TRANSFER_ID}}
/reversals
\ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -d amount=7000

Las revocaciones de envíos de fondos agregan el importe especificado (o el total) nuevamente al saldo de la plataforma, reduciendo el saldo disponible de la cuenta conectada según corresponda. Un envío de fondos se puede revertir solo si el saldo disponible de la cuenta conectada es mayor que el importe de la revocación o si tiene reservas conectadas habilitadas.

Si la revocación de la transferencia requiere una conversión de monedas y el monto revocado resultaría en un saldo de cero después de la conversión, se arrojará un error.

Deshabilitar los reembolsos de una cuenta conectada no bloqueará la capacidad de procesar anulaciones de transferencias.

Consulta también

  • Cómo trabajar con varias monedas
  • Descripción del cargo en el extracto bancario con Connect
  • Cómo interpretar los saldos de las cuentas Connect
¿Te fue útil esta página?
SíNo
¿Necesitas ayuda? Ponte en contacto con soporte.
Únete a nuestro programa de acceso anticipado.
Echa un vistazo a nuestro registro de cambios.
¿Tienes alguna pregunta? Contacto.
¿LLM? Lee llms.txt.
Con tecnología de Markdoc