# Descripciones de los cargos en el extracto bancario

Descubre cómo funcionan las descripciones de los cargos en el extracto bancario.

Para obtener información sobre cómo configurar las descripciones del cargo en el extracto bancario para las cuentas conectadas, consulta [Configuración de las descripciones del cargo en el extracto bancario para las cuentas conectadas](https://docs.stripe.com/connect/statement-descriptors.md).

Las descripciones del extracto explican los cargos o pagos en los extractos bancarios. La utilización de descripciones de los cargos en el extracto bancario claras y precisas puede reducir los contracargos y las disputas. Los bancos y las redes de tarjetas exigen la inclusión de determinados tipos de información que ayuden a los clientes a entender sus extractos, y los descriptores de los cargos en el extracto bancario proporcionan esta información.

Al [configurar tu cuenta de Stripe](https://docs.stripe.com/get-started/account/set-up.md#public-business-information), puedes establecer una única descripción del cargo en el extracto bancario (descripción estática del cargo) que aparecerá en todos los extractos del cliente. Para los cargos de tarjeta, también puedes crear una descripción del cargo en el extracto bancario que contenga un prefijo estático asociado a tu cuenta, pero con un sufijo dinámico asociado a cada cargo. Esto te permite especificar detalles sobre el producto, el servicio o el pago en los extractos bancarios.

La mayoría de los bancos muestran esta información de forma coherente, pero algunos pueden mostrarla de forma incorrecta o no mostrarla en absoluto.

## Requisitos de la descripción del cargo en el extracto bancario

La descripción del cargo en el extracto bancario completa, ya sea una única descripción estática o la combinación de un prefijo y un sufijo, debe cumplir los siguientes requisitos:

- Contiene solo caracteres latinos.
- Contener entre 5 y 22 caracteres, inclusive.
- Contiene al menos una letra (si se utiliza un prefijo y un sufijo, se requiere al menos una letra en ambos casos).
- No contiene ninguno de los siguientes caracteres especiales: `<`, `>`, `\`, `'` `"` `*`.
- Refleja tu nombre comercial (DBA).
- Contiene más de un término común o una URL de sitio web común. La URL de un sitio web solo es aceptable si ofrece una descripción clara y precisa de una transacción en el extracto bancario del cliente.

Un prefijo estático, también llamado descripción abreviada en el Dashboard, debe contener entre 2 y 10 caracteres, ambos inclusive. Los caracteres restantes se reservan para el sufijo dinámico.

El límite de 22 caracteres se aplica a la descripción completa. La API valida el valor de `statement_descriptor_suffix` con su propio límite de 22&nbsp;caracteres, por lo que un sufijo puede superar la validación y, aun así, no caber en la descripción completa. Consulta [cómo encajar el sufijo en la descripción completa](https://docs.stripe.com/get-started/account/statement-descriptors.md#suffix-length).

## Configura la descripción del cargo en el extracto bancario estática o el prefijo

Puedes configurar una descripción del cargo en el extracto bancario estática o una versión corta (el prefijo) en el [Dashboard](https://dashboard.stripe.com/settings/business-details). Este valor aparece en todos los extractos de los clientes para pagos o cargos que no se realizan con tarjeta.

Es suficiente una descripción estática del cargo en el extracto bancario si:

- Tu empresa solo ofrece un único producto o servicio.
- Tus clientes perciben un valor estático para cualquier transacción con tu empresa.
- Prefieres proporcionar la misma descripción del cargo en el extracto bancario para todas las transacciones.

Para los cargos en la tarjeta, plantéate un prefijo estático con un sufijo dinámico si:

- Ofreces varios productos o servicios.
- Es posible que tus clientes no perciban un único valor por todas sus transacciones con tu empresa.
- Prefieres proporcionar datos específicos por transacción en la descripción del cargo en el extracto bancario.

Puedes configurar la descripción del cargo en el extracto bancario para cargos que no se realizan con tarjeta y el prefijo corto de la descripción para los cargos que se realizan con tarjeta.

Si configuras la descripción del cargo en el extracto bancario estática, pero no especificas un prefijo, Stripe usará la descripción del cargo en el extracto bancario estática como prefijo para los pagos con tarjeta. Si tiene más de 10 caracteres, la truncamos para que se ajuste al límite de caracteres.

## Establece un sufijo dinámico

Los sufijos dinámicos solo se pueden utilizar para pagos con tarjeta. Usa el sufijo para especificar los detalles de la transacción de modo que tu cliente pueda interpretarla claramente en su extracto. El sufijo se concatena con el prefijo, el símbolo `*` y un espacio para formar la descripción del cargo en el extracto bancario que ve el cliente.

Por ejemplo, si el prefijo es `RUNCLUB` y el sufijo es `OCT MARATHON`, la descripción completa del cargo en el extracto bancario es `RUNCLUB* OCT MARATHON`.

Especifica el sufijo en el parámetro [statement_descriptor_suffix](https://docs.stripe.com/api/payment_intents/create.md#create_payment_intent-statement_descriptor_suffix) del `PaymentIntent`:

```curl
curl https://api.stripe.com/v1/payment_intents \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d amount=1099 \
  -d currency=usd \
  -d "automatic_payment_methods[enabled]=true" \
  -d statement_descriptor_suffix=INV-123456
```

Si usas *Checkout* (A low-code payment integration that creates a customizable form for collecting payments. You can embed Checkout directly in your website, redirect customers to a Stripe-hosted payment page, or create a customized checkout page with Stripe Elements), especifica el sufijo en el parámetro [payment_intent_data.statement_descriptor_suffix](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-payment_intent_data-statement_descriptor_suffix) de la `CheckoutSession`.

### Cómo encajar el sufijo en la descripción completa

Stripe comprueba la longitud del sufijo y la de la descripción completa por separado:

- **Si el sufijo tiene más de 22&nbsp;caracteres**: la petición falla y devuelve un error.
- **Si el sufijo tiene 22&nbsp;caracteres o menos, pero la descripción completa tiene más de 22&nbsp;caracteres**: la petición se procesa correctamente y Stripe trunca la descripción completa. Es posible que tu cliente no vea el final del sufijo.

El sufijo puede usar hasta 22&nbsp;caracteres menos la longitud de tu prefijo, menos 2 más por el símbolo `*` y el espacio. En algunos casos, Stripe asigna menos espacio al sufijo. Stripe siempre reserva al menos 10&nbsp;caracteres para el sufijo, por lo que un sufijo de 10&nbsp;caracteres o menos siempre cabe con cualquier prefijo válido.

Por ejemplo, si el prefijo es `RUNCLUB` (7&nbsp;caracteres), el sufijo puede contener hasta 13&nbsp;caracteres:

| Sufijo | Longitud | Resultado |
| --- | --- | --- |
| `INV-123456789` | 13 | El sufijo más largo que puede utilizarse con este prefijo. |
| `INV-1234567890` | 14 | La petición se procesa correctamente, pero el sufijo es más largo que el espacio disponible, por lo que Stripe trunca la descripción completa. |

Después de crear el pago, comprueba el valor de [calculated_statement_descriptor](https://docs.stripe.com/api/charges/object.md#charge_object-calculated_statement_descriptor) del `cargo` resultante para ver la descripción completa que ha calculado Stripe. Este campo solo muestra el resultado después del pago, por lo que no puedes usarlo para comprobar un sufijo de antemano. El emisor de la tarjeta sigue controlando cómo aparece la descripción en el extracto.

Estas reglas se aplican a las descripciones de los cargos en los extractos bancarios en caracteres latinos. Para los sufijos kanji y kana, consulta los [requisitos de la descripción del cargo en el extracto bancario en japonés](https://docs.stripe.com/get-started/account/statement-descriptors.md#japanese-requirements).

## Anular la descripción del cargo en el extracto bancario predeterminada

### Pagos únicos

Puedes anular la descripción del cargo en el extracto bancario estática de un pago que no se realiza con tarjeta al especificar un valor para [statement_descriptor](https://docs.stripe.com/api/payment_intents/object.md#payment_intent_object-statement_descriptor) cuando creas el `PaymentIntent`.

Para los pagos con tarjeta, no puedes especificar `statement_descriptor`. Solo puedes especificar `statement_descriptor_suffix`.

### Suscripciones y facturas

Debido a que Stripe crea los cargos de suscripción automáticamente, no puedes especificar `statement_descriptor` o `statement_descriptor_suffix` en el `PaymentIntent` asociado. Para anular la descripción del cargo en el extracto bancario predeterminada de un pago de suscripción o factura, puedes hacer una de estas cosas:

- Actualizar la `Invoice` para especificar [statement_descriptor](https://docs.stripe.com/api/invoices/update.md#update_invoice-statement_descriptor).
- Especificar `statement_descriptor` al [crear](https://docs.stripe.com/api/products/create.md#create_product-statement_descriptor) o [actualizar](https://docs.stripe.com/api/products/update.md#update_product-statement_descriptor) un `Product`.

> #### Cómo actualizar las facturas
> 
> Normalmente, no se pueden editar las [facturas de suscripción](https://docs.stripe.com/billing/invoices/subscription.md) finalizadas. Si quieres añadir una descripción del cargo en el extracto bancario personalizada a una factura de suscripción, especifica en [collection_method](https://docs.stripe.com/api/subscriptions/create.md#create_subscription-collection_method) de la `Subscription` la opción `send_invoice`. También puede que necesites especificar false en [auto_advance](https://docs.stripe.com/api/invoices/update.md#update_invoice-auto_advance) de la `Invoice`.

Al crear un pago de suscripción, Stripe selecciona la descripción del cargo en el extracto bancario en este orden de prioridad:

1. El definido en la `Invoice`.
2. El definido en el `Product`, incluso un `Product` asociado a un `Plan` o `Price` de la factura. Si una `Subscription` contiene varios artículos, Stripe utilizará el primero de su matriz [items.data](https://docs.stripe.com/api/subscriptions/object.md#subscription_object-items-data) (no de la matriz `lines.data` de la `Invoice`) que tenga una descripción del cargo en el extracto bancario personalizada.
3. La descripción del cargo en el extracto bancario predeterminada para el tipo de cargo.

## Configurar descripciones de los cargos en el extracto bancario para cuentas de Japón

Las empresas japonesas pueden establecer descripciones de los cargos en los extractos bancarios en kanji y kana. Es importante que las descripciones de los cargos en los extractos bancarios sean claras y fáciles de entender para reducir la confusión y los contracargos. Te recomendamos configurar las descripciones de los cargos en los extractos bancarios en los tres sistemas de escritura aceptados (kanji, kana y caracteres latinos).

En el [Dashboard](https://dashboard.stripe.com/settings/business-details) de tu cuenta, puedes cambiar las descripciones [estáticas](https://docs.stripe.com/get-started/account/statement-descriptors.md#static) de los cargos en el extracto bancario en kanji y kana, así como las descripciones acortadas (es decir, los prefijos).

Para los cargos a tarjetas, puedes establecer [sufijos dinámicos](https://docs.stripe.com/get-started/account/statement-descriptors.md#dynamic) en kanji y kana en los `PaymentIntents` y en las `CheckoutSessions`. Creamos la descripción completa que ven los titulares de tarjetas concatenando el prefijo y los separadores acortados, de la misma forma que lo hace `statement_descriptor_suffix`.

En el siguiente ejemplo verás cómo configurar sufijos en kanji y kana en un `PaymentIntent`.

```curl
curl https://api.stripe.com/v1/payment_intents \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d amount=1000 \
  -d currency=jpy \
  -d "automatic_payment_methods[enabled]=true" \
  -d "statement_descriptor_suffix=example descriptor" \
  -d "payment_method_options[card][statement_descriptor_suffix_kanji]=漢字サフィックス" \
  -d "payment_method_options[card][statement_descriptor_suffix_kana]=カナサフィックス"
```

### Requisitos

Aunque las descripciones de los cargos de los extractos bancarios en japonés comparten algunos [requisitos con las descripciones en inglés](https://docs.stripe.com/get-started/account/statement-descriptors.md#requirements), la siguiente tabla muestra otros requisitos necesarios para las descripciones en kanji y kana.

|  | Kanji | Kana |
| --- | --- | --- |
| Longitud total máxima | 17 | 22 |
| Longitud mínima del prefijo | 1 | 2 |
| Longitud máxima del prefijo | 10 | 10 |
| Tipo de carácter aceptado | Kanji, kana y alfabeto latino | Kana |
| Regla de validación | No se permiten `< > \ ' " * *` | Solo se permiten kana, espacios, guiones y puntos |

> La longitud total se puede referir tanto a la descripción estática como a la descripción concatenada (prefijo + separador + sufijo). Se truncarán las descripciones que excedan el máximo de caracteres.

### Comportamiento del emisor

Las descripciones de los cargos en japonés en el extracto bancario solo están disponibles cuando se cumplen las dos condiciones siguientes:

- La tarjeta es una Visa o Mastercard emitida en Japón.
- El cargo se procesa por parte de una empresa japonesa procesa o en nombre de una empresa japonesa.

Para los cargos aplicables, la mayoría de los emisores utilizan una descripción del cargo en el extracto bancario en japonés en lugar de en latín. Sin embargo, en última instancia, es el emisor quien decide si muestra kanji, kana o caracteres latinos en el extracto bancario del titular de la tarjeta.

El [calculated_statement_descriptor](https://docs.stripe.com/api/charges/object.md#charge_object-calculated_statement_descriptor) en las respuestas de API siempre es la descripción del cargo en el extracto bancario en alfabeto latino, pero eso no impide que el emisor utilice una descripción del cargo en el extracto bancario en japonés.

### Tiempo de visualización de la descripción del cargo en el extracto bancario

Las descripciones del cargo en los extractos bancarios en kanji y kana se envían a los emisores en el momento de la captura del pago. Como resultado, suelen tardar unos días en aparecer en el extracto bancario del titular de la tarjeta. Mientras tanto, es posible que los titulares de las tarjetas puedan ver una descripción temporal:

- **Visa, Mastercard:** la descripción del cargo en el extracto bancario en inglés.
- **JCB, Diners Club y Discover:** la descripción del cargo en el extracto bancario predeterminado de la cuenta.
