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 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 a un panel alojado por Stripe pueden actualizar la configuración de sus propias descripciones 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.

curl https://api.stripe.com/v1/accounts \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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"

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 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 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 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.

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 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 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.

curl https://api.stripe.com/v1/accounts \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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

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.

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_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:

curl https://api.stripe.com/v1/accounts \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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]"="カナメイサイ"

Al crear cargos con tarjeta, puedes establecer sufijos dinámicos en kanji y kana con payment_method_options[card][statement_descriptor_suffix_kanji] y payment_method_options[card][statement_descriptor_suffix_kana].

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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.