Ir a contenido
Crea una cuenta
 o
Inicia sesión
Logotipo de Stripe Docs
/
Crear una cuenta
Iniciar sesión
ResumenActualiza tu integración
Pagos electrónicos
ResumenEncuentra tu caso de usoPagos administrados
Métodos de pago
Interfaces de pago
Escenarios de pago
Pagos en persona
Más allá de los pagos

Aceptar una transferencia bancaria

Utiliza la API Payment Intents para aceptar pagos con transferencia bancaria.

La primera vez que aceptas un pago mediante transferencia bancaria de un cliente, Stripe genera una cuenta bancaria virtual para ese cliente, que luego puedes compartir con esa persona directamente. Todos los pagos futuros con transferencia bancaria de ese cliente se envían a esta cuenta bancaria. En algunos países, Stripe también te proporciona un número de referencia para transferencias exclusivo que tu cliente debe incluir en cada transferencia a fin de facilitar la comparación entre la transferencia y los pagos pendientes. En algunos países hay límites en la cantidad de números de cuentas bancarias virtuales que puedes crear gratis.

Puedes encontrar un resumen de los pasos más comunes para aceptar un pago mediante transferencia bancaria en el siguiente diagrama de secuencia:

Manejo de pagos insuficientes y sobrepagos

En el caso de los pagos con transferencia bancaria, es posible que el cliente te envíe un importe mayor o menor que el importe de pago previsto. Si el cliente envía un importe menor, Stripe cubre parte de un Payment Intent abierto. Las facturas no se cubren en parte, sino que quedan abiertas hasta que se reciben fondos para cubrir el importe total.

Si el cliente envía un importe mayor que el previsto, Stripe intenta conciliar los fondos recibidos con un pago abierto y mantendrá lo que sobre del importe en el saldo de caja del cliente. Puedes encontrar más detalles sobre cómo Stripe gestiona la conciliación en la sección Conciliación de nuestra documentación.

Cuando un cliente paga un importe inferior:

Cuando un cliente paga un importe superior:

Cómo gestionar varias facturas o pagos abiertos

Puedes tener varias facturas o pagos abiertos que se pueden saldar con una transferencia bancaria. Según la configuración predeterminada, Stripe hará el intento de conciliar automáticamente la transferencia bancaria utilizando datos como el código de referencia de la transferencia o el importe transferido.

Puedes deshabilitar la conciliación automática y conciliar manualmente pagos y facturas tú mismo. Puedes omitir el comportamiento de conciliación automática por cliente configurando el modo de conciliación en manual.

Configurar Stripe
Lado del servidor

Primero, necesitas una cuenta de Stripe. Inscríbete ahora.

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

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

Crear o recuperar un objeto Customer
Lado del servidor

Debes asociar un objeto Customer para conciliar cada pago mediante transferencia bancaria. Si ya tienes un “Customer Object”, puedes omitir este paso. De lo contrario, crea un nuevo “Customer Object”.

Command Line
curl -X POST https://api.stripe.com/v1/customers \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

Crear un PaymentIntent
Lado del servidor

Un PaymentIntent es un objeto que representa tu intención de cobrar a un cliente y hace el seguimiento del ciclo de vida del proceso de pago en cada etapa. Crea un PaymentIntent de lado del servidor y especifica el importe y la moneda del cobro. También debes completar el parámetro customer de la solicitud de creación del PaymentIntent. Las transferencias bancarias no están disponibles en PaymentIntents sin un cliente.

Antes de crear un Payment Intent, asegúrate de activar Transferencia bancaria en la página de configuración de métodos de pago de tu Dashboard.

Nota

Con los métodos de pago dinámicos, Stripe gestiona la devolución de los métodos de pago elegibles en función de factores como el importe de la transacción, la moneda y el flujo de pagos.

Command Line
curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=1099 \
  -d customer=
{{CUSTOMER_ID}}
 \
  -d currency=usd \
  -d "automatic_payment_methods[enabled]"=true

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.

Si el cliente ya tiene fondos suficientes en el saldo para cubrir el importe del pago, el PaymentIntent se concretará de inmediato y se mostrará el estado succeeded. Los clientes pueden acumular fondos en el saldo si pagan de más por una transacción por error, algo que es común en las transferencias bancarias. Debes conciliar los saldos del cliente en un plazo determinado en función de tu ubicación.

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.

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/basil/stripe.js"></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');

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.

Una vez recibida la confirmación, Stripe abre automáticamente un cuadro de diálogo para mostrarle los datos de la transferencia bancaria al cliente.

Enviar 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;
  }
});

Confirma que el PaymentIntent se procesó correctamente

El estado del PaymentIntent es requires_action hasta que los fondos llegan a la cuenta bancaria. Cuando los fondos están listos, el estado del PaymentIntent se actualiza y pasa de requires_action a succeeded.

Tu punto de conexión de webhooks debe estar configurado para empezar a recibir el evento payment_intent.partially_funded. Cuando solo se paga parte del PaymentIntent, el estado sigue siendo requires_action.

Puedes agregar un webhook desde el Dashboard.

Como opción, puedes usar la API Webhook Endpoints para empezar a recibir el evento payment_intent.partially_funded.

Precaución

La CLI de Stripe no admite la activación de eventos de la versión beta de la API, como payment_intent.partially_funded.

Los siguientes eventos se envían durante el movimiento de los fondos del pago cuando se actualiza el PaymentIntent.

EventoDescripciónPróximos pasos
payment_intent.requires_actionSe envía durante la confirmación cuando no hay fondos suficientes en el saldo de cliente para conciliar el PaymentIntent. El estado del PaymentIntent pasa a requires_action.Indícale a tu cliente que envíe una transferencia bancaria con el amount_remaining.
payment_intent.partially_fundedEl cliente envió una transferencia bancaria que se aplicó al PaymentIntent, pero no fue suficiente para completar el pago. Esto puede deberse a que el cliente transfirió un importe insuficiente (a causa de un error en el pago o a comisiones cobradas por el banco) o a que se le aplicó al PaymentIntent un saldo restante del cliente. Los PaymentIntents pagados en forma parcial no se reflejan en el saldo de tu cuenta hasta que se completa el pago.Indícale al cliente que envíe otra transferencia bancaria con el nuevo amount_remaining para completar el pago. Si quieres completar el pago con los fondos aplicados en forma parcial, puedes actualizar el amount y confirmar el PaymentIntent nuevamente.
payment_intent.succeededEl pago del cliente se efectuó correctamente.Entrega los bienes o servicios que el cliente compró.

Precaución

Cuando cambias el importe de un PaymentIntent parcialmente financiado, los fondos se devuelven al saldo del cliente. Si hay otros PaymentIntents abiertos, Stripe los financia automáticamente. Si el cliente está configurado para realizar la conciliación manual, debes aplicar los fondos de nuevo.

Te recomendamos usar webhooks para confirmar que el cobro se haya efectuado correctamente y notificar al cliente que se efectivizó el pago.

Código de ejemplo

require 'json'

# Using Sinatra
post '/webhook' do
  payload = request.body.read
  event = nil

  begin
    event = Stripe::Event.construct_from(
      JSON.parse(payload, symbolize_names: true)

Ver pagos pendientes en el Dashboard

Puedes ver todos los PaymentIntents pendientes asociados con transferencias bancarias en el Dashboard aplicando el filtro En espera de fondos al campo Estado.

Probar tu integración

Puedes probar tu integración simulando una transferencia bancaria entrante con la API, a través del Dashboard o con una versión beta de la CLI de Stripe.

Para simular una transferencia bancaria usando el Dashboard en un entorno de prueba, navega a la página del cliente en el Dashboard. En Métodos de pago, haz clic en Agregar y selecciona Agregar fondos al saldo de caja (solo modo de prueba).

Cómo gestionar problemas temporales de disponibilidad

Los siguientes códigos de error indican errores temporales en la disponibilidad del método de pago:

CódigoDescripciónGestión
payment_method_rate_limit_exceededSe realizaron demasiadas solicitudes en poco tiempo para este método de pago, cuyos límites son más estrictos que los límites de frecuencia de toda la API.Estos errores pueden aparecer en varias solicitudes de API si muchos clientes intentan usar el mismo método de pago, por ejemplo, porque se ofrece una rebaja en tu sitio web. En este caso, pídeles a los clientes que usen otro método de pago.

Precaución

Si prevés un consumo intensivo en general o debido a un próximo evento, contáctanos tan pronto como lo sepas.

¿Te fue útil esta página?
SíNo