Definir las descripciones de los cargos en el extracto bancario 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.
Definir el componente estático para una cuenta conectada
La descripción del cargo en el extracto bancario contiene 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).
- La primera mitad de la descripción del cargo en el extracto bancario es estática (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.
La descripción del cargo en el extracto bancario se establece de una de las siguientes maneras:
- Con una llamada a la API para crear o actualizar una cuenta
- Durante el onboarding alojado o integrado en Stripe
- A través del Dashboard completo de Stripe o de Express.
Las cuentas conectadas con acceso al Dashboard completo de Stripe o al Dashboard de Express pueden actualizar la configuración de su descripción del cargo en el extracto bancario.
Puedes completar automáticamente la descripción del cargo en el extracto bancario y el prefijo de una cuenta cuando llamas al punto de conexión de creación de cuenta. Durante el onboarding alojado o integrado en Stripe, si no se establece settings.payments.statement_descriptor
o settings.card_payments.statement_descriptor_prefix
, Stripe los establece según la información suministrada sobre la cuenta durante el onboarding. Si no hay información suficiente disponible, Stripe le indica a las cuentas conectadas que establezcan sus propias descripciones del cargo durante el onboarding.
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.
Para las cuentas en las que la plataforma se encarga del onboarding, debes establecer su descripción del cargo en el extracto bancario.
A partir de la versión de API 2023-10-16, hay una nueva lógica en torno a la actualización de la descripción del cargo en el extracto bancario.
- 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 elbusiness_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 delbusiness_profile.name
y estableces o actualizas el nombre de la empresa o del particular, dicha descripción no se restablecerá porque elbusiness_profile.name
tiene mayor prioridad. El orden de prioridad esbusiness_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.
El extracto del cliente utiliza el componente estático de la cuenta conectada para los siguientes tipos de cargos:
- Cargos Direct
- Cargos a un Destino con
on_behalf_of
- Cargos y envíos de fondos separados con
on_behalf_of
Precaución
La plataforma proporciona el componente estático para solicitudes /v1/charges
con on_behalf_of
para las versiones de API anteriores a 2019-02-19
.
El uso del componente estático en las cuentas conectadas exige la funcionalidad card_payments.
El extracto del cliente utiliza el componente estático de la cuenta de la plataforma para los siguientes tipos de cargos:
- Cargos a un Destino sin
on_behalf_of
- Cargos y envíos de fondos separados sin
on_behalf_of
Toda información adicional que aparezca en el extracto de un cliente también proviene de la cuenta que proporciona el componente estático (por ejemplo, dirección de soporte o número de teléfono de soporte). Si la cuenta conectada no ha proporcionado esta información, los cargos on_behalf_of
utilizan la información de la cuenta de la plataforma.
Si usas un sufijo dinámico en un cargo que utiliza la descripción estática de la cuenta conectada, puedes definir el prefijo para asegurarte de que la descripción completa aparezca según lo previsto.
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.
Define statement_descriptor
y statement_descriptor_prefix
para tener flexibilidad a la hora de definir las descripciones de los cargos en el extracto.
Si la descripción se define sin un prefijo en cargos con tarjeta, Stripe trunca la descripción del cargo en el extracto de la cuenta para definir el valor del prefijo.
Definir un sufijo dinámico para cargos de cuentas conectadas
Solo se aceptan sufijos dinámicos para cargos con tarjeta si se utiliza el parámetro statement_descriptor_suffix
. Puedes obtener más información sobre los sufijos dinámicos o consultar las descripciones concatenadas de los cargos en el extracto bancario (prefijo* sufijo) en el Dashboard.
Configurar descripciones de los cargos en el extracto bancario para cuentas de Japón
We recommend setting the static components of kanji and kana statement descriptors for Japanese connected accounts.
You can set all descriptors and their corresponding prefixes when creating a Japanese Custom connected account as follows:
You can set dynamic kanji and kana suffixes when creating card charges with payment_method_options[card][statement_descriptor_suffix_kanji]
and 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.