# Definir las descripciones de los cargos en el extracto bancario con Connect Descubre cómo funcionan las descripciones de los cargos en el extracto bancario para los cargos con Connect. Estas descripciones del cargo en el extracto bancario sirven para explicar los cargos o pagos en los extractos bancarios e incluyen información que los bancos y las redes de tarjetas exigen para ayudar a los clientes a entender su extractos. Infórmate sobre los [requisitos de las descripciones del cargo en el extracto bancario](https://docs.stripe.com/get-started/account/statement-descriptors.md). ## Definir el componente estático para una cuenta conectada Las descripciones del cargo en el extracto bancario contienen un componente estático y, como opción, una parte dinámica. El componente estático se refiere a una de las siguientes situaciones: - Toda la descripción del cargo en el extracto bancario es estática ([settings.payments.statement_descriptor](https://docs.stripe.com/api/accounts/object.md#account_object-settings-payments-statement_descriptor)). - La primera mitad de la descripción del cargo en el extracto bancario es estática ([settings.card_payments.statement_descriptor_prefix](https://docs.stripe.com/api/accounts/object.md#account_object-settings-card_payments-statement_descriptor_prefix)) y la segunda mitad se establece de manera dinámica a partir del pago. Tu plataforma y cuentas conectadas con la funcionalidad `card_payments` deben tener una descripción del cargo en el extracto bancario y, opcionalmente, un prefijo de dicha descripción. Ambos valores deben tener al menos 5 caracteres de longitud. Para un pago determinado, se aplica la descripción del cargo en el extracto bancario de la plataforma o la cuenta conectada según [el tipo de cargo](https://docs.stripe.com/connect/charges.md). La descripción del cargo en el extracto bancario se establece de una de las siguientes maneras: - Con una llamada API para [crear o actualizar una cuenta](https://docs.stripe.com/api/accounts.md) - Durante el onboarding alojado o integrado en Stripe - A través del Dashboard completo de Stripe o de Express. Las cuentas conectadas con *acceso a un panel alojado por Stripe* (Platforms can provide connected accounts with access to the full Stripe Dashboard or the Express Dashboard. Otherwise, platforms build an interface for connected accounts using embedded components or the Stripe API) pueden actualizar la configuración de sus propias descripciones del cargo en el extracto bancario. Puede completar de forma anticipada la descripción del cargo en el extracto bancario y el prefijo cuando llames al punto de conexión [crear cuenta](https://docs.stripe.com/api/cuentas/crear.md). Durante el onboarding alojado o incrustado en Stripe, si `settings.payments.statement_descriptor` no está establecido, Stripe lo genera concatenando las siguientes cadenas: 1. `business_profile.name` 1. Nombre comercial 1. `business_profile.url` 1. el nombre de la entidad jurídica (ya sea `individual.first_name` + `individual.last_name` o `company.name`). Si `settings.payments.statement_descriptor_prefix` no está completado de forma anticipada, Stripe lo establece utilizando los 10 primeros caracteres de la descripción del cargo en el extracto bancario. Si la información requerida no está disponible, el onboarding alojado o integrado en Stripe solicita a la cuenta que establezca su propia descripción del cargo en el extracto bancario y prefijo. Después de realizar el onboarding de una cuenta que no tiene acceso al Dashboard completo de Stripe, puedes actualizar su `settings.payments.statement_descriptor` y `settings.card_payments.statement_descriptor_prefix` llamando al punto de conexión de [actualización de la cuenta](https://docs.stripe.com/api/accounts/update.md). Para las cuentas en las que la plataforma se encarga del onboarding, debes establecer su descripción del cargo en el extracto bancario. #### Con propiedades de controlador ```curl curl https://api.stripe.com/v1/accounts \ -u "<>:" \ -d "controller[stripe_dashboard][type]=none" \ -d "controller[fees][payer]=application" \ -d "controller[losses][payments]=application" \ -d "controller[requirement_collection]=application" \ -d country=US \ -d business_type=company \ -d "business_profile[name]=Runners Club" \ -d "capabilities[card_payments][requested]=true" \ -d "capabilities[transfers][requested]=true" \ -d "settings[payments][statement_descriptor]=RUNNERS CLUB" ``` #### Con tipo de cuenta ```curl curl https://api.stripe.com/v1/accounts \ -u "<>:" \ -d type=custom \ -d country=US \ -d business_type=company \ -d "business_profile[name]=Runners Club" \ -d "capabilities[card_payments][requested]=true" \ -d "capabilities[transfers][requested]=true" \ -d "settings[payments][statement_descriptor]=RUNNERS CLUB" ``` Si actualizas el `business_profile.name`, `business_profile.url` o el nombre de la empresa o del particular de la cuenta, y la descripción del cargo en el extracto bancario existente se basa en datos de menor prioridad, Stripe restablecerá automáticamente la descripción del cargo para que coincida con el valor de prioridad más alto. Por ejemplo, si la descripción del cargo en el extracto bancario se establece automáticamente según la URL, cuando establezcas o actualices el `business_profile.name`, Stripe restablecerá la descripción para que coincida con el nombre del perfil de la empresa. Si la descripción del cargo en el extracto bancario se establece automáticamente en función del `business_profile.name` y estableces o actualizas el nombre de la empresa o del particular, dicha descripción no se restablecerá porque el `business_profile.name` tiene mayor prioridad. El orden de prioridad es `business_profile.name`, `business_profile.url` y, luego, el nombre de la empresa o particular. Las actualizaciones de la descripción del cargo en el extracto bancario completo de una cuenta hace que Stripe establezca automáticamente el prefijo de la descripción en una versión abreviada de la descripción actualizada del cargo en el extracto bancario, incluso si el prefijo anterior se estableció manualmente. ## Consumo de la descripción del cargo en el extracto bancario La descripción completa del cargo en el extracto bancario se proporciona al banco o a la red de tarjetas que procesa el pago. Solo se envían los primeros 22 caracteres de la descripción completa del cargo para los pagos con tarjeta. En el extracto del cliente se utiliza el [componente estático](https://docs.stripe.com/connect/statement-descriptors.md#set-the-static-component-for-a-connected-account) de la cuenta de la plataforma para los siguientes tipos de cargo: - Cargos a un Destino sin `on_behalf_of` - Cargos y envíos de fondos separados sin `on_behalf_of` En el extracto del cliente se utiliza el [componente estático](https://docs.stripe.com/connect/statement-descriptors.md#set-the-static-component-for-a-connected-account) de la cuenta conectada para los siguientes tipos de cargo: - Cargos Direct - Cargos a un destino con `on_behalf_of` - Cargos y envíos de fondos separados con `on_behalf_of` El uso del componente estático desde una cuenta conectada requiere que la cuenta tenga la funcionalidad `card_payments`. > Para las versiones de API `2019-02-19` y posteriores, el parámetro [`statement_descriptor`](https://docs.stripe.com/api/charges/create.md#create_charge-statement_descriptor) de `/v1/charges` se trata como componente dinámico y equivale a proporcionar un `statement_descriptor_suffix`. > > Si se proporcionan ambos `statement_descriptor_suffix` y `statement_descriptor`, solo se usa `statement_descriptor_suffix`. > > Para las versiones de API anteriores a `2019-02-19`, los parámetros de la descripción del cargo en el extracto bancario en `/v1/charges` se ignoran y se utiliza la descripción estática del cargo en el extracto bancario de la plataforma. Junto con la descripción del cargo en el extracto bancario, se envía información adicional sobre la empresa para que se muestre en el extracto del cliente (por ejemplo, dirección, correo electrónico, teléfono y URL). La información adicional se utiliza de forma predeterminada en las propiedades de soporte [business_profile](https://docs.stripe.com/api/accounts/object.md#account_object-business_profile) de la cuenta. Si no se proporciona un campo de soporte, se usa el campo de soporte de la plataforma. Si este campo no está disponible, en su lugar, se proporciona la información de identidad de la cuenta. ### Comportamientos on_behalf_of En el caso de los cargos establecidos en `on_behalf_of`, la descripción del cargo en el extracto bancario y la información de la empresa se buscan primero en la cuenta especificada. Si no se establece esa información, se utiliza la información de la plataforma. - Si el cargo tiene un componente dinámico, se utiliza el componente estático [settings.card_payments.statement_descriptor_prefix](https://docs.stripe.com/api/accounts/object.md#account_object-settings-payments-statement_descriptor_prefix) de la cuenta conectada. Si la cuenta conectada no tiene configurado un prefijo de descripción del cargo en el extracto bancario, se utiliza el prefijo de la plataforma. - Si no está definida la información del perfil de la empresa de la cuenta conectada, se utiliza la información de la plataforma (primero el perfil de empresa de la plataforma y, después, su información de identidad). Por ejemplo, si la cuenta conectada no tiene configurado un `support_phone`, se proporciona el `support_phone` o el número de teléfono de identidad de la plataforma. Si usas un sufijo dinámico en un cargo que utiliza la descripción estática de la cuenta conectada, te recomendamos configurar un prefijo en la cuenta conectada para que la descripción completa del cargo en el extracto bancario aparezca como se pretende. #### Con propiedades de controlador ```curl curl https://api.stripe.com/v1/accounts \ -u "<>:" \ -d "controller[stripe_dashboard][type]=none" \ -d "controller[fees][payer]=application" \ -d "controller[losses][payments]=application" \ -d "controller[requirement_collection]=application" \ -d country=US \ -d business_type=company \ -d "capabilities[card_payments][requested]=true" \ -d "capabilities[transfers][requested]=true" \ -d "settings[card_payments][statement_descriptor_prefix]=RUNCLUB" ``` #### Con tipo de cuenta ```curl curl https://api.stripe.com/v1/accounts \ -u "<>:" \ -d type=custom \ -d country=US \ -d business_type=company \ -d "capabilities[card_payments][requested]=true" \ -d "capabilities[transfers][requested]=true" \ -d "settings[card_payments][statement_descriptor_prefix]=RUNCLUB" ``` El prefijo estático debe contener entre 2 y 10 caracteres, inclusive. Las redes de tarjetas reciben solo los primeros 22 caracteres (se incluye el símbolo `*` y el espacio que concatena el prefijo estático y el sufijo dinámico) de la descripción completa del cargo del extracto bancario. Configura tanto el descriptor como el prefijo para contar con flexibilidad al establecer descripciones del cargo en el extracto bancario. Si la descripción del cargo en el extracto bancario se establece en cargos con tarjeta y no se define un prefijo, Stripe truncará la descripción del cargo en el extracto bancario según sea necesario para establecer el valor del prefijo. ## Definir un sufijo dinámico para cargos de cuentas conectadas Solo se admiten sufijos dinámicos para cargos con tarjeta usando el parámetro PaymentIntents [statement_descriptor_suffix](https://docs.stripe.com/api/payment_intents/object.md?api-version=preview). Puedes leer más sobre [los sufijos dinámicos](https://docs.stripe.com/get-started/account/statement-descriptors.md#dynamic) o ver las descripciones concatenadas de los cargos en el extracto bancario en el [Dashboard](https://dashboard.stripe.com/settings/public). ```curl curl https://api.stripe.com/v1/payment_intents \ -u "<>:" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d amount=1000 \ -d currency=usd \ -d "payment_method_types[]=card" \ -d "statement_descriptor_suffix=Custom suffix" ``` ## Configurar descripciones de los cargos en el extracto bancario para cuentas de Japón Te recomendamos configurar los componentes estáticos de las descripciones del cargo en el extracto bancario en kanji y kana para las cuentas conectadas de Japón. Puedes establecer todas las descripciones y sus prefijos correspondientes al crear una cuenta conectada japonesa: #### Con propiedades de controlador ```curl curl https://api.stripe.com/v1/accounts \ -u "<>:" \ -d "controller[stripe_dashboard][type]=none" \ -d "controller[fees][payer]=application" \ -d "controller[losses][payments]=application" \ -d "controller[requirement_collection]=application" \ -d country=JP \ -d business_type=company \ -d "capabilities[card_payments][requested]=true" \ -d "capabilities[transfers][requested]=true" \ -d "settings[card_payments][statement_descriptor_prefix]=example prefix" \ -d "settings[card_payments][statement_descriptor_prefix_kanji]=漢字プリフィックス" \ -d "settings[card_payments][statement_descriptor_prefix_kana]=カナプリフィックス" \ -d "settings[payments][statement_descriptor]=example descriptor" \ -d "settings[payments][statement_descriptor_kanji]=漢字明細" \ -d "settings[payments][statement_descriptor_kana]=カナメイサイ" ``` #### Con tipo de cuenta ```curl curl https://api.stripe.com/v1/accounts \ -u "<>:" \ -d type=custom \ -d country=JP \ -d business_type=company \ -d "capabilities[card_payments][requested]=true" \ -d "capabilities[transfers][requested]=true" \ -d "settings[card_payments][statement_descriptor_prefix]=example prefix" \ -d "settings[card_payments][statement_descriptor_prefix_kanji]=漢字プリフィックス" \ -d "settings[card_payments][statement_descriptor_prefix_kana]=カナプリフィックス" \ -d "settings[payments][statement_descriptor]=example descriptor" \ -d "settings[payments][statement_descriptor_kanji]=漢字明細" \ -d "settings[payments][statement_descriptor_kana]=カナメイサイ" ``` Al crear cargos con tarjeta, puedes establecer sufijos dinámicos en kanji y kana con [payment_method_options[card][statement_descriptor_suffix_kanji]](https://docs.stripe.com/api/payment_intents/create.md?api-version=preview#create_payment_intent-payment_method_options-card-statement_descriptor_suffix_kanji) y [payment_method_options[card][statement_descriptor_suffix_kana]](https://docs.stripe.com/api/payment_intents/create.md?api-version=preview#create_payment_intent-payment_method_options-card-statement_descriptor_suffix_kana). ```curl curl https://api.stripe.com/v1/payment_intents \ -u "<>:" \ -d amount=1000 \ -d currency=jpy \ -d "payment_method_types[]=card" \ -d "statement_descriptor_suffix=example descriptor" \ -d "payment_method_options[card][statement_descriptor_suffix_kanji]=漢字サフィックス" \ -d "payment_method_options[card][statement_descriptor_suffix_kana]=カナサフィックス" ``` Para obtener más información, consulta las [descripciones de los cargos en el extracto bancario para cuentas de Japón](https://docs.stripe.com/get-started/account/statement-descriptors.md#set-japanese-statement-descriptors).