Transfiere dinero

Instala las bibliotecas oficiales de Stripe para acceder a la API desde tu aplicación:

# Available as a gem
sudo gem install stripe

# If you use bundler, you can add this line to your Gemfile
gem 'stripe'

Cuando un usuario (un vendedor o proveedor de servicios) abre una cuenta en tu plataforma, crea un objeto Account de usuario (que será la cuenta conectada) para que puedas aceptar pagos y transferir fondos a su cuenta bancaria. Las cuentas conectadas representan a tus usuarios en la API de Stripe y facilitan la recopilación de los datos solicitados para que Stripe pueda verificar la identidad del usuario. En el caso de un producto de preguntas y respuestas que paga por las respuestas, la cuenta conectada representa al escritor.

Personaliza tu formulario de creación de cuentas

En la configuración de la plataforma, puedes personalizar tu formulario de creación de cuentas Express. Para ello, cambia el color y los logotipos que verán los usuarios cuando hagan clic en el enlace de Connect.

Formulario de creación de cuentas Express predeterminado

Configuración de imagen de marca

Crear una cuenta conectada y completar la información automáticamente

Use the /v1/accounts API to create a connected account by specifying the connected account properties, or by specifying the account type.

curl https://api.stripe.com/v1/accounts \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d "controller[losses][payments]"=application \
  -d "controller[fees][payer]"=application \
  -d "controller[stripe_dashboard][type]"=express

Si ya recopilaste información para tus cuentas conectadas, puedes completar automáticamente esa información en el objeto Account. Puedes completar automáticamente todo tipo de información de la cuenta, por ejemplo, los datos personales y de la empresa, la información externa de la cuenta y más.

Connect Onboarding doesn’t ask for the prefilled information. However, it does ask the account holder to confirm the prefilled information before accepting the Connect service agreement.

When testing your integration, prefill account information using test data.

Crea un enlace de cuenta

Crea un objeto Account Link con los siguientes argumentos:

• account
• refresh_url
• return_url
• type = account_onboarding

curl https://api.stripe.com/v1/account_links \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d account=
{{CONNECTED_ACCOUNT_ID}} \
  --data-urlencode refresh_url="https://example.com/reauth" \
  --data-urlencode return_url="https://example.com/return" \
  -d type=account_onboarding

Redirige al usuario al enlace de cuenta

La respuesta a tu solicitud de Account Links incluye un valor para la clave url. Redirige a tu usuario a este enlace. Las direcciones URL desde la API Account Links son temporales y solo se pueden utilizar una vez, ya que otorgan acceso a los datos personales del titular de la cuenta. Autentica a los usuarios en tu aplicación antes de redirigirlos a esta URL. Si quieres completar los datos automáticamente, debes hacerlo antes de generar el enlace de la cuenta. Después de haber creado el enlace de la cuenta, no podrás leer ni escribir información para la cuenta conectada.

Gestiona el caso de un usuario que vuelve a la plataforma

El onboarding de Connect requiere que especifiques una return_url y una refresh_url para gestionar todos los casos en los que se redirige al usuario a tu plataforma. Es importante implementarlas correctamente para que el usuario tenga la mejor experiencia.

return_url

Stripe redirige al usuario a esta URL cuando dicho usuario completa el flujo de onboarding de Connect. Esto no implica que se haya recopilado toda la información ni que no haya requisitos pendientes en la cuenta. Solo significa que se entró y se salió del flujo correctamente.

No se especifica ningún estado a través de esta URL. Después de redirigir al usuario a tu return_url, verifica el estado del parámetro details_submitted en su cuenta por medio de uno de los siguientes métodos:

• Escucha los eventos account.updated.
• Llamando a la API Accounts e inspeccionando el objeto devuelto

refresh_url

Tu usuario es redirigido a la refresh_url en los siguientes casos:

• Se venció el enlace (pasaron algunos minutos desde que se creó).
• El enlace ya se visitó (el usuario actualizó la página o se desplazó de página en el navegador).
• El enlace se compartió en una aplicación de terceros, como un cliente de mensajería que intenta acceder a la URL para obtener una vista previa. Muchos clientes visitan automáticamente enlaces, lo que hace que estos se venzan.
• Tu plataforma ya no puede acceder a la cuenta.
• Se rechazó la cuenta.

La refresh_url debe volver a llamar a Account Links en tu servidor con los mismos parámetros y redirigir al usuario al flujo de onboarding de Connect para crear una experiencia fluida.

Gestiona los casos de usuarios que no hayan completado el onboarding

Es posible que un usuario redirigido a tu return_url no haya completado el proceso de onboarding. Usa el punto de conexión /v1/accounts para recuperar la cuenta del usuario y comprueba si hay charges_enabled. Si la cuenta no ha finalizado todo el proceso de onboarding, proporciona indicaciones de interfaz de usuario para que el usuario pueda continuarlo más tarde. Podrá completar la activación de su cuenta con un nuevo enlace de cuenta (generado por tu integración). Puedes verificar el estado del parámetro details_submitted en su cuenta para ver si se completó el proceso de onboarding.

Para agregar fondos, ve a la sección Saldo del Dashboard. Haz clic en Agregar al saldo y selecciona el motivo por el que agregas fondos a tu cuenta.

Selecciona Transferir a cuentas conectadas para agregar fondos a fin de hacer transferencias a tus cuentas conectadas. Si agregas fondos para cubrir disputas y reembolsos futuros o para cubrir saldos negativos de tu plataforma, selecciona Cubrir saldos negativos y consulta cómo agregar fondos a tu saldo de Stripe.

Verifica tu cuenta bancaria

La primera vez que intentes agregar fondos desde una cuenta bancaria no verificada, completa el proceso de verificación en el Dashboard. Si tu cuenta bancaria no está verificada, tendrás que confirmar dos microdepósitos de Stripe. Estos aparecerán en tu extracto bancario en línea en dos días hábiles como máximo. Verás el término ACCTVERIFY como descripción del cargo.

Cuando los microdepósitos llegan a tu cuenta, Stripe te notifica en el Dashboard y por correo electrónico. Para completar el proceso de verificación, haz clic en la notificación del Dashboard en la sección Saldo, ingresa los importes de ambos microdepósitos y haz clic en Verificar cuenta.

Crea una recarga

Una vez que tu cuenta esté verificada, crea una top-up para agregar fondos al saldo de la cuenta.

curl https://api.stripe.com/v1/topups \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d amount=2000 \
  -d currency=usd \
  -d description="Top-up for week of May 31" \
  -d statement_descriptor="Weekly top-up"

Cuando transfieres fondos, aparece una descripción del cargo en tu extracto bancario que identifica la transacción. La descripción predeterminada del cargo en el extracto es Recarga. Puedes personalizar tanto la descripción en el extracto bancario como la descripción interna.

Ver fondos

Puedes ver tus fondos en el Dashboard, en la pestaña Recargas que se encuentra en la página de Saldo. Cada vez que agregues fondos, se creará un objeto Top-up con un número de identificación único cuyo formato es tu_XXXXXX. Podrás ver el número en la vista detallada de la recarga.

Plazo de acreditación de fondos

Las plataformas de EE. UU. agregan fondos mediante débito ACH. Los fondos pueden tardar entre cinco y seis días hábiles en acreditarse en el saldo de Stripe. Para solicitar una revisión de tu cuenta a fin de acelerar el plazo de acreditación de fondos, ponte en contacto con el soporte de Stripe.

A medida que Stripe va conociendo tu cuenta, es posible que pueda acortar automáticamente el plazo de acreditación de fondos.

Se pueden agregar fondos para disputas y reembolsos futuros o para cubrir saldos negativos mediante transferencia bancaria o electrónica. Los fondos estarán disponibles en el plazo de uno o dos días hábiles.

Puedes transferir fondos disponibles a una cuenta conectada usando la API. Por ejemplo, para transferir USD 10 a una cuenta, puedes hacer la siguiente llamada:

curl https://api.stripe.com/v1/transfers \
  -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -d amount=1000 \
  -d currency="usd" \
  -d destination="{{CONNECTED_STRIPE_ACCOUNT_ID}}"

De manera predeterminada, todos los fondos que transfieras a una cuenta conectada se acumularán en el saldo de Stripe de la cuenta conectada y se transferirán diariamente en forma continua. Puedes modificar el calendario de transferencias según sea necesario.

Desde el Dashboard de tu cuenta, puedes ver la cuenta y su saldo.

Utiliza los tokens bancarios de prueba para simular flujos de cuentas y onboarding, hacer transferencias y agregar fondos.