Definir descrições no extrato com o Connect

As descrições no extrato explicam cobranças ou pagamentos nos extratos bancários e incluem informações exigidas pelos bancos e bandeiras de cartão para ajudar os clientes a entender os extratos. Conheça os requisitos de descrições no extrato.

Definir o componente estático para uma conta conectada

As descrições do extrato contêm um componente estático e, opcionalmente, uma parte dinâmica. O componente estático se refere a:

• Toda a descrição no extrato é estática (settings.payments.statement_descriptor).
• A primeira metade da descrição do extrato é estática (settings.card_payments.statement_descriptor_prefix) e a segunda metade é dinamicamente definida a partir do pagamento.

Sua plataforma e as contas conectadas com a card_payments precisam ter uma descrição no extrato e, opcionalmente, um prefixo na descrição no extrato. Ambos os valores precisam ter pelo menos 5 caracteres. Para um determinado pagamento, a descrição no extrato da plataforma ou da conta conectada é aplicada dependendo do tipo de cobrança.

A descrição no extrato é definida de uma das seguintes maneiras:

• Com uma chamada da API criar ou atualizar conta
• Durante o onboarding hospedado ou integrado pela Stripe
• Pelo Stripe Dashboard completo ou Express Dashboard

Contas conectadas com acesso a um Dashboard hospedado pela Stripe podem atualizar as próprias configurações de descrição no extrato.

É possível preencher automaticamente tanto o prefixo quanto a descrição que aparecerá no extrato do cliente ao utilizar o endpoint criar conta. Durante o processo de onboarding, seja pelo Stripe hospedado ou incorporado, caso settings.payments.statement_descriptor não tenha sido definido, o Stripe montará automaticamente o texto de extrato a partir da combinação das seguintes informações:

1. business_profile.name
2. “fazendo negócios como”
3. business_profile.url
4. nome completo da pessoa física (individual.first_name + individual.last_name) ou razão social (company.name).

Caso o valor settings.payments.statement_descriptor_prefix não tenha sido informado previamente, o Stripe o gerará utilizando os 10 primeiros caracteres do descritor de extrato.

Quando essas informações estiverem ausentes, a interface hospedada ou embutida do Stripe pedirá que o titular da conta insira manualmente o descritor e o prefixo de extrato desejados.

Após fazer o onboarding de uma conta que não tem acesso ao Stripe Dashboard completo, você pode atualizar suas settings.payments.statement_descriptor e settings.card_payments.statement_descriptor_prefix chamando o endpoint de atualização da conta.

Para contas em que a plataforma processa onboarding, você precisa definir a descrição no extrato.

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 da versão de API 2023-10-16, uma nova lógica é utilizada para atualizar descrições no extrato.

• Se você atualizar business_profile.name, business_profile.url ou o nome da empresa ou do indivíduo e a descrição no extrato existente for baseada em dados de precedência inferior, a Stripe redefine automaticamente a descrição no extrato para corresponder ao valor de precedência superior. Por exemplo, se a descrição do extrato for definida automaticamente com base no URL, você define ou atualiza business_profile.name, a Stripe redefine a descrição no extrato para corresponder ao nome do perfil da empresa. Se a descrição no extrato for definida automaticamente com base em business_profile.name e você definir ou atualizar o nome da empresa ou do indivíduo, a descrição no extrato não será redefinida porque business_profile.name tem precedência mais alta. A ordem de precedência é business_profile.name, business_profile.url e o nome da empresa ou do indivíduo.
• Qualquer atualização na descrição no extrato completa de uma conta faz com que a Stripe defina automaticamente o prefixo dessa descrição para uma versão mais curta da descrição no extrato atualizada, mesmo que o prefixo anterior seja definido manualmente.

Uso da descrição no extrato

A descrição completa no extrato é fornecida ao banco ou na bandeira de cartão que processa o pagamento. Somente os primeiros 22 caracteres da descrição completa no extrato são enviados para pagamentos com cartão.

O extrato do cliente usa o componente estático da conta da plataforma para os seguintes tipos de cobrança

• Cobranças de destino sem on_behalf_of
• Cobranças e transferências separadas sem on_behalf_of

O extrato do cliente usa o componente estático da conta conectada para os seguintes tipos de cobrança

• Cobranças diretas
• Cobranças de destino com on_behalf_of
• Cobranças e transferências separadas com on_behalf_of

O uso do componente estático de uma conta conectada exige que a conta tenha a função card_payments.

Junto com uma descrição no extrato, outras informações sobre a empresa são enviadas para exibição no extrato do cliente (por exemplo, endereço, e-mail, telefone e URL). As informações adicionais são definidas como padrão como propriedades de suporte do business_profile da conta. Se um campo de suporte não for informado, o campo de suporte da plataforma será usado. Se o campo de suporte da plataforma não estiver disponível, os dados de identificação da conta serão fornecidos.

Comportamentos on_behalf_of

Para cobranças com on_behalf_of definidos, a descrição no extrato e os dados comerciais são primeiramente consultados na conta especificada. Se esses dados não forem definidos, os dados da plataforma serão utilizados.

• Se a cobrança tiver um componente dinâmico, o componente estático de configurações.card_payments.statement_descriptor_prefix da conta conectada será utilizado. Se a conta conectada não tiver um prefixo de descrição no extrato definido, o prefixo da descrição no extrato da plataforma será utilizado.
• Se os dados do perfil comercial da conta conectada não estiverem definidos, os dados da plataforma serão usados (primeiro o perfil comercial da plataforma e depois os dados de identificação da plataforma). Por exemplo, se a conta conectada não tiver um support_phone definido, o support_phone da plataforma ou o número de telefone da identidade será informado.

Se você usa um sufixo dinâmico em uma cobrança que utiliza a descrição estática da conta conectada, recomendamos definir um prefixo para na conta conectada para que a descrição completa no extrato seja exibida corretamente.

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

O prefixo estático deve conter entre 2 e 10 caracteres. As bandeiras de cartão recebem apenas os 22 primeiros caracteres (incluindo o símbolo * e o espaço que concatena o prefixo estático e o sufixo dinâmico) da descrição completa no extrato.

Defina statement_descriptor e statement_descriptor_prefix para ter flexibilidade na configuração de descrições no extrato em cobranças.

Quando a descrição no extrato é definida em cobranças com cartão e nenhum prefixo é definido, a Stripe trunca a descrição no extrato da conta para definir o valor do prefixo.

Definir um sufixo dinâmico para cobranças de contas conectadas

Os sufixos dinâmicos são aceitos apenas para cobranças em cartão utilizando o parâmetro statement_descriptor_suffix. Leia mais sobre sufixos dinâmicos ou veja as descrições de extrato concatenadas (prefixo* sufixo) no 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"

Definir descrições no extrato em japonês

Recomendamos definir os componentes estáticos das descrições no extrato em kanji e kana para contas conectadas japonesas. Você pode definir todas as descrições e os prefixos correspondentes ao criar uma conta 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]"="カナメイサイ"

Você pode definir sufixos dinâmicos em kanji e kana quando criar cobranças de cartão com payment_method_options[card][statement_descriptor_suffix_kanji] e 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]"="カナサフィックス"

Consulte Descrições no extrato em japonês para obter mais informações.