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 uso
Métodos de pago
Payment interfaces
Payment scenarios
Pagos en persona
Other Stripe products

Nota

Esta página aún no está disponible en este idioma. Estamos trabajando intensamente para que nuestra documentación esté disponible en más idiomas. Ofreceremos la traducción en cuanto esté disponible.

Aceptar una transferencia bancaria

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

The first time you accept a bank transfer payment from a customer, Stripe generates a virtual bank account for them, which you can then share with them directly. All future bank transfer payments from this customer get sent to this bank account. In some countries, Stripe also provides you with a unique transfer reference number that your customer should include with each transfer to make it easier to match the transfer against outstanding payments. Some countries have limits on the number of virtual bank account numbers that you can create for free.

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

Handling underpayments and overpayments

With bank transfer payments, it’s possible that the customer sends you more or less than the expected payment amount. If the customer sends too little, Stripe partially funds an open payment intent. Invoices won’t be partially funded and remain open until incoming funds cover the full invoice amount.

If the customer sends more than the expected amount, Stripe attempts to reconcile the incoming funds against an open payment and keep the remaining excess amount in the customer cash balance. You can find more details on how Stripe handles reconciliation in the reconciliation section of our documentation.

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.

Configura 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'

Crea o recupera un objeto Customer
Lado del servidor

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

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

Crea y confirma un PaymentIntent
Lado del servidor

Un PaymentIntent es un objeto que representa tu intención de cobrarle a un cliente y hace el seguimiento del ciclo de vida del proceso de pago en cada etapa. Crea y confirma un PaymentIntent en el servidor y especifica el importe y la moneda del cobro. También debes completar el parámetro del cliente de la solicitud de creación de 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

With Dynamic payment methods, Stripe handles the return of eligible payment methods based on factors such as the transaction’s amount, currency, and payment flow.

Command Line
curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d amount=1099 \
  -d customer=
{{CUSTOMER_ID}}
 \
  -d currency=usd \
  -d "automatic_payment_methods[enabled]"=true \
  --data-urlencode return_url="https://example.com/return_url" \
  -d "payment_method_data[type]"=customer_balance \
  -d confirm=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.

If the customer already has a balance high enough to cover the payment amount, the PaymentIntent immediately succeeds with a succeeded status. Customers can accrue a balance when they accidentally overpay for a transaction—a common occurrence with bank transfers. You must reconcile customer balances within a certain period based on your location.

Indícale a tu cliente que complete una transferencia bancaria.
Lado del cliente

Si el saldo del cliente no tiene fondos suficientes para cubrir el importe solicitado, el estado del PaymentIntent es requires_action. La respuesta tiene un campo next_action que contiene un valor type de display_bank_transfer_instructions. El hash next_action[display_bank_transfer_instructions] contiene información que debes mostrar a tu cliente para que pueda completar la transferencia bancaria.

Nota

En modo activo, Stripe proporciona a cada cliente un conjunto único de datos de transferencias bancarias. Por el contrario, Stripe ofrece datos de transferencias bancarias no válidos para todos los clientes en modo de prueba. A diferencia del modo activo, es posible que estos datos no válidos no siempre sean únicos.

CampoDescripción
typeEl tipo de transferencia bancaria que se usará. En Estados Unidos, el tipo debe ser us_bank_transfer.
referenceUn código de referencia único para identificar la transferencia bancaria. Indícale a tu cliente que incluya este código en el campo de referencia de su transferencia bancaria.
amount_remainingEl importe restante que se debe transferir para completar el pago. Indícale a tu cliente que transfiera este importe. Puede ser diferente del importe del PaymentIntent si se aplicaron fondos preexistentes en el saldo del cliente al PaymentIntent o si el cliente pagó menos dinero.
currencyLa moneda del importe restante.
financial_addressesLista de direcciones financieras de las cuentas bancarias de Estados Unidos. Los tipos incluidos son aba y swift. Consulta los detalles a continuación.
hosted_instructions_urlUn enlace a la página alojada que guía al cliente a lo largo del proceso de transferencia.

aba hash

Ejemplo de un hash aba:

{
  "aba": {
    "account_number": "111222333444",
    "bank_name": "Wells Fargo Bank, NA",
    "routing_number": "444555666"
  },
  "supported_networks": [
    "ach",
    "domestic_wire_us"
  ],
  "type": "aba"
}
CampoValor(es)Descripción
typeabaEl tipo de dirección financiera.
supported_networks
  • ach
  • domestic_wire_us
La lista de redes compatibles con esta dirección.
aba.account_number111222333444El número ABA de la cuenta.
aba.routing_number444555666El número ABA de enrutamiento.
aba.bank_nameWells Fargo Bank, NAEl nombre del banco.

hash de swift

Ejemplo de un hash swift:

{
  "swift": {
    "account_number": "111222333444",
    "bank_name": "Wells Fargo Bank, NA",
    "swift_code": "AAAA-BB-CC-123"
  },
  "supported_networks": [
    "swift"
  ],
  "type": "swift"
}
CampoValor(es)Descripción
typeswiftEl tipo de dirección financiera.
supported_networks
  • swift
La lista de redes compatibles con esta dirección.
swift.account_number111222333444El número SWIFT de la cuenta.
swift.swift_codeAAAA-BB-CC-123El código SWIFT.
swift.bank_nameWells Fargo Bank, NAEl nombre del banco.

Plazo de acreditación de fondos

Después de indicarle a tu cliente que inicie una transferencia en su banco con la información proporcionada, la transferencia puede tardar hasta cinco días en completarse. El plazo de acreditación de fondos depende de los canales bancarios a través de los cuales la transferencia llegó a Stripe:

  • Las transferencias de ACH llegan dentro de 1 a 3 días hábiles.
  • Las transferencias bancarias nacionales (Fedwire) llegan el mismo día (si la transferencia se envía antes de la hora límite del banco).
  • Las transferencias bancarias internacionales (SWIFT) llegan dentro de 1 a 5 días hábiles.

Confirma el PaymentIntent procesado correctamente

El estado del PaymentIntent permanece en 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.

Debes configurar tu punto de conexión de webhook para empezar a recibir el evento payment_intent.partially_funded.

You can add a webhook from the Dashboard.

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

Stripe envía los siguientes eventos durante el movimiento de los fondos del pago cuando actualizamos el PaymentIntent.

EventoDescripciónPróximos pasos
payment_intent.requires_actionSe envía durante la confirmación cuando no hay suficientes fondos en el saldo de cliente para conciliar el PaymentIntent; el PaymentIntent pasa a requires_action.Indícale a tu cliente que envíe una transferencia bancaria con el amount_remaining.
payment_intent.partially_fundedThe customer sent a bank transfer that was applied to the PaymentIntent, but wasn’t enough to complete the payment. This might happen because the customer transferred an insufficient amount (because of a mistaken underpayment or fees charged by their bank) or because a remaining customer balance was applied to this PaymentIntent. PaymentIntents that are partially funded aren’t reflected in your account balance until the payment is complete.Solicítale a tu cliente que envíe otra transferencia bancaria con el nuevo amount_remaining para efectivizar el pago. Si quieres efectivivizar 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, tienes que 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)

View pending payments in the Dashboard

You can view all pending bank transfer PaymentIntents in the Dashboard by applying the Waiting on funding filter to Status .

Prueba tu integración

Puedes probar tu integración simulando una transferencia bancaria entrante a través del Dashboard o con una solicitud HTTP.

With the Dashboard

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

With the Stripe API

You can make an API call to simulate a bank transfer.

Command Line
curl https://api.stripe.com/v1/test_helpers/customers/ic_xxxxxxxxx/fund_cash_balance \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d amount=1000 \
  -d currency=usd \
  -d reference=REF-4242

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ódigoDescriptionHandling
payment_method_rate_limit_exceededToo many requests were made in quick succession for this payment method, which has stricter limits than the API-wide rate limits.These errors can persist for several API requests when many of your customers try to use the same payment method, such as during an ongoing sale on your website. In this case, ask your customers to choose a different payment method.

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
¿Necesitas ayuda? Ponte en contacto con soporte.
Únete a nuestro programa de acceso anticipado.
Consulta nuestro registro de cambios de productos.
¿Tienes alguna pregunta? Contacto.
Con tecnología de Markdoc
En esta página
Handling underpayments and overpayments
Cómo gestionar varias facturas o pagos abiertos
Configura Stripe
Crea o recupera un objeto Customer
Crea y confirma un PaymentIntent
Indícale a tu cliente que complete una transferencia bancaria.
Confirma el PaymentIntent procesado correctamente
Código de ejemplo
View pending payments in the Dashboard
Prueba tu integración
Cómo gestionar problemas temporales de disponibilidad
Productos utilizados
Payments
Invoicing
Checkout
Elements