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 completo ao Stripe Dashboard ou ao Dashboard Express podem atualizar suas próprias configurações de descrição no extrato.
Você pode preencher a descrição e o prefixo do extrato da conta quando chamar o endpoint de criação de conta. Durante o onboarding hospedado ou integrado pela Stripe, se settings.payments.statement_descriptor
ou settings.card_payments.statement_descriptor_prefix
não estiverem definidas, a Stripe as define com base nas informações fornecidas sobre a conta durante o onboarding. Se não houver dados suficientes, a Stripe solicitará que as contas conectadas definam suas próprias descrições no extrato durante o onboarding.
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.
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 atualizabusiness_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 embusiness_profile.name
e você definir ou atualizar o nome da empresa ou do indivíduo, a descrição no extrato não será redefinida porquebusiness_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 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
Cuidado
Nas versões de API anteriores a 2019-02-19
, a plataforma fornece o componente estático para solicitações /v1/charges
com on_behalf_of
.
O uso do componente estático em contas conectadas exige a função card_payments.
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
Todas as informações adicionais exibidas no extrato de um cliente também são fornecidas pela conta que disponibiliza o componente estático (por exemplo, endereço ou telefone do suporte). Quando a conta conectada não fornece esses dados, as cobranças on_behalf_of
usam os dados da conta da plataforma.
Se você usa um sufixo dinâmico em uma cobrança que utiliza a descrição estática da conta conectada, pode definir um prefixo para que toda a descrição no extrato seja exibida corretamente.
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.
Definir descrições no extrato em japonês
Recomendamos definir os componentes estáticos de descrições no extrato em kanji e kana para contas conectadas japonesas.
Você ainda pode definir todas as descrições e os prefixos correspondentes da seguinte maneira ao criar uma conta conectada Custom japonesa:
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]
.
Consulte Descrições no extrato em japonês para obter mais informações.