Ir a contenido
Crea una cuenta o inicia sesión
Logotipo de la documentación de Stripe
/
Crear cuentaIniciar sesión

Creación de destinatarios alojados por StripeVista previa pública

Aprende a realizar el onboarding de los destinatarios utilizando un formulario alojado en Stripe.

Utiliza el formulario web alojado en Stripe para recoger la información del destinatario, que se presenta de forma dinámica en función de las funcionalidades, país y métodos de pago de cada destinatario.

Utiliza la API Account Links para generar enlaces mediante programación para recoger información con formularios alojados en Stripe, que se adapta dinámicamente en función de las funcionalidades, el país y los métodos de pago de cada destinatario, y que puedes personalizar con el nombre de la empresa, los colores de tu marca y tu icono. Tus destinatarios completan el formulario alojado y envían los datos solicitados, incluidas las credenciales para las transferencias (por ejemplo, cuenta bancaria y número de ruta) directamente a Stripe.

El destinatario introduce su información en el formulario
El destinatario acepta conectar sus credenciales para las transferencias a Stripe
Una pantalla de confirmación muestra al destinatario que está listo para recibir transferencias

Navegadores compatibles

El formulario para recoger datos alojado en Stripe es compatible con los siguientes navegadores para ordenadores y móviles:

  • Las 20 versiones más recientes de Chrome y Firefox
  • Las dos versiones principales más recientes de Safari y Edge
  • Las dos versiones principales más recientes de Safari para dispositivos móviles en iOS
  • Entornos sin iframe

Personalizar el formulario de recogida de datos

Para personalizar los formularios alojados en Stripe, ve a la página de configuración de la marca de la empresa para incluir el nombre de la empresa, el color y el icono.

Crear un destinatario

Vista previa pública

Las transferencias transfronterizas para remitentes de EE. UU. están disponibles en vista previa pública.

Usa la API Accounts v2 para crear tu destinatario. Debes especificar los métodos de transferencia previstos porque algunos métodos necesitan información adicional sobre tu destinatario para que puedan habilitarse. Los métodos que habilitas usando el parámetro funcionalidades determinan la información que debes solicitar a tu destinatario (por ejemplo, configuration.recipient.capabilities.bank_accounts.local para un destinatario en EE. UU. requiere que envíes una cuenta y número de ruta).

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl -X POST https://api.stripe.com/v2/core/accounts \
  -H "Authorization: Bearer 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
" \
  -H "Stripe-Version: 2025-12-15.preview" \
  --json '{
    "contact_email": "jenny.rosen@example.com",
    "display_name": "Jenny Rosen",
    "identity": {
        "country": "us",
        "entity_type": "individual"
    },
    "configuration": {
        "recipient": {
            "capabilities": {
                "bank_accounts": {
                    "local": {
                        "requested": true
                    }
                }
            }
        }
    },
    "include": [
        "requirements",
        "configuration.recipient",
        "identity"
    ]
  }'

Después de añadir estos campos y los métodos de transferencia solicitados, Stripe determina la información adicional necesaria en la respuesta de la API que debes enviar para que el destinatario esté listo para recibir transferencias.

Método de transferenciaParámetro APIDescripción
Banco localconfiguration.recipient.capabilities.bank_accounts.localPermite que la cuenta reciba OutboundPayments a través de redes bancarias locales, como ACH o FPS.
Transferencia bancariaconfiguration.recipient.capabilities.bank_accounts.wirePermite que la cuenta reciba OutboundPayments a través de redes electrónicas, como Fedwire o SWIFT.
Tarjetasconfiguration.recipient.capabilities.cardsPermite que la cuenta reciba OutboundPayments en redes de tarjetas de débito, como Visa Direct o Mastercard Send.

Un destinatario puede tener habilitados varios métodos de transferencia. No todos los métodos de transferencia están disponibles para los destinatarios de todos los países. Consulta la lista completa de métodos disponibles por país.

Después de añadir estos campos y los métodos de transferencia solicitados, Stripe determina la información adicional necesaria en la respuesta de la API que debes enviar para que el destinatario esté listo para recibir transferencias.

Crear un enlace compartible

Crea un enlace compartible con la API Account Link. Envías este enlace a tu destinatario, que después tiene acceso al formulario de recogida de datos para enviar la información necesaria directamente a Stripe. Cada URL de AccountLink caduca 10 minutos después de que se genere y se puede usar una única vez. Si tu destinatario hace clic en AccountLink después del plazo de 10 minutos, se le redirige a refresh.url por motivos de seguridad. Después de que tu destinatario proporcione su información, AccountLink redirige a la return.url.

Versión beta privada

¿Te interesa verificar a tus destinatarios? Después de que los destinatarios compartan los datos de su método de transferencia en formularios alojados en Stripe, usa la API Financial Connections para ver y confirmar los datos de titularidad asociados con la cuenta (bancaria) vinculada. Si quieres acceder, enter your email.

Para crear un enlace compartible, incluye los siguientes parámetros:

  • cuenta: el ID de la cuenta del destinatario, que puedes obtener usando la API Accounts v2
  • use_case.type: si recoges la información del destinatario por primera vez, especifica account_onboarding.
  • use_case.count_onboarding.configurations: establecido al destinatario.
  • use_case.count_onboarding.return_url: la página a la que Stripe redirige al destinatario cuando ya se haya visitado AccountLink, ha caducado o no es válida.
  • use_case.count_onboarding.actualizar_url: la página a la que Stripe redirige al destinatario cuando completa o abandona el formulario de recogida de datos.

La siguiente solicitud crea un AccountLink para recoger la información de un destinatario por primera vez:

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl -X POST https://api.stripe.com/v2/core/account_links \
  -H "Authorization: Bearer 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
" \
  -H "Stripe-Version: 2025-12-15.preview" \
  --json '{
    "account": "{{ACCOUNT_ID}}",
    "use_case": {
        "type": "account_onboarding",
        "account_onboarding": {
            "configurations": [
                "recipient"
            ],
            "return_url": "https://example.com/return",
            "refresh_url": "https://example.com/reauth"
        }
    }
  }'

Autenticar al destinatario en tu aplicación antes de redirigirlo a esta URL.

Versión beta privada

¿Te interesa contar con herramientas de autenticación adicionales? Stripe también ofrece una función de código de acceso único para reautenticar a tu destinatario enviando un código de autenticación a su correo electrónico y redirigiéndolo después a un nuevo AccountLink. Si quieres acceder, enter your email.

Confirmación del cheque del beneficiario UK only

Necesitamos comprobar la confirmación del beneficiario antes de pagar a destinatarios del Reino Unido. Realiza esta verificación cuando crees la cuenta bancaria o usa una llamada a la API por separado.

Proporciona los siguientes parámetros en tu solicitud a /v2/payment_methods/gb_bank_accounts:

Parámetro APIObligatorioDescripción
account_numberSíEl número de cuenta de la cuenta bancaria.
sort_codeSíEl código Sort de la cuenta bancaria (solo numérico).
confirmation_of_payeeNoDetermina si quieres comprobar la cuenta bancaria de tu destinatario.

El encabezado Stripe-Context en estas solicitudes debe ser el ID de la cuenta del destinatario.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl -X POST https://api.stripe.com/v2/core/vault/gb_bank_accounts \
  -H "Authorization: Bearer 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
" \
  -H "Stripe-Version: 2025-12-15.preview" \
  -H "Stripe-Context: 
{{CONTEXT}}
" \
  --json '{
    "sort_code": "108800",
    "account_number": "00012345",
    "confirmation_of_payee": {
        "initiate": true
    }
  }'

A continuación te mostramos una respuesta de ejemplo:

{
  "id": "gbba_123",
  "object": "payment_methods.gb_bank_account",
  "bank_account_type": "checking",
  "bank_name": "Test Bank",
  "created": "2023-05-15T16:29:15.738Z",
  "deactivated": false,
  "last4": "2345",
  "sort_code": "108800",
  "confirmation_of_payee": {
    "result": {
      "created": "2024-10-18T19:19:31.000Z",
      "match_result": "mismatch",
      "matched": {
        "business_type": null,
        "name": ""
      },
      "message": "The provided information does not match the information the bank has on file for this account.",
      "provided": {
        "business_type": "business",
        "name": "John Smith"
      }
    },
    "status": "awaiting_acknowledgement"
  },
}

Si el resultado de la confirmación del beneficiario coincide, puedes enviar fondos inmediatamente a este destino. Si el resultado coincide parcialmente, no coincide o el servicio no está disponible, primero debes confirmar el resultado:

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl -X POST https://api.stripe.com/v2/core/vault/gb_bank_accounts/gbba_1234/acknowledge_confirmation_of_payee \
  -H "Authorization: Bearer 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
" \
  -H "Stripe-Version: 2025-12-15.preview" \
  -H "Stripe-Context: 
{{CONTEXT}}
"

Revisa estas cuentas bancarias para asegurarte de que sean correctas antes de confirmarlas. También puedes revisar cuentas bancarias que no coincidan en el dashboard.

La confirmación de destinatario está habilitada

Para que un destinatario acepte transferencias, debes recoger información sobre el destinatario y los métodos de transferencia previstos.

Después de que un destinatario acceda al formulario de recogida de datos desde el enlace compartible y envía la información solicitada, se activa el webhook v2.core.account_link.returned. Este evento de webhook te permite saber cuándo se ha completado correctamente el proceso de AccountLink y el destinatario está listo para aceptar transferencias. Obtén más información sobre los webhooks y cómo gestionarlos.

También puedes determinar si un destinatario está listo para aceptar transferencias usando el Dashboard o la API Accounts v2.

  1. Ve a Destinatarios y selecciona el destinatario.
  2. Confirma que no se requiere información adicional. Se muestra un banner en la página si necesitamos información adicional del destinatario (por ejemplo, «Se necesita información» o «Cuenta bancaria predeterminada no establecida»). De lo contrario, se completa la recogida de información del destinatario.
  3. Confirma que al menos un método de transferencia está habilitado en Métodos de transferencia. De lo contrario, debes solicitar un método de transferencia compartiendo otro enlace o utilizando la API. Para crear otro enlace compartible, utiliza de nuevo la API Account Links.

Realizar actualizaciones en un destinatario existente

Puedes permitir que los destinatarios actualicen su información en el formulario alojado en Stripe creando otro enlace compartible con la API Account Links.

Para crear un nuevo enlace compartible, incluye lo siguiente:

  • cuenta: el ID de la cuenta del destinatario, que puedes obtener usando la API Accounts v2
  • use_case.type: especifica la account_update.
  • use_case.count_onboarding.configurations: establecido al destinatario.
  • use_case.count_onboarding.return_url: la página a la que Stripe redirige al destinatario después de que ya se haya visitado AccountLink, haya caducado o no sea válida.
  • use_case.count_onboarding.actualizar_url: la página a la que Stripe redirige al destinatario cuando completa o abandona el formulario de recogida de datos.
Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl -X POST https://api.stripe.com/v2/core/account_links \
  -H "Authorization: Bearer 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
" \
  -H "Stripe-Version: 2025-12-15.preview" \
  --json '{
    "account": "{{ACCOUNT_ID}}",
    "use_case": {
        "type": "account_update",
        "account_onboarding": {
            "configurations": [
                "recipient"
            ],
            "return_url": "https://example.com/return",
            "refresh_url": "https://example.com/reauth"
        }
    }
  }'

Al igual que la AccountLink utilizada para crear el destinatario, la URL caduca después de 10 minutos y solo se puede utilizar una vez. Si tu destinatario abre la URL pasado el plazo de 10 minutos o más de una vez, lo redirigimos a refresh.url.