Soft Descriptor
O soft-descriptor é um texto adicional que será apresentado junto ao nome do estabelecimento na fatura do cartão de crédito do comprador. Este texto pode ser definido no cadastro da loja ou na requisição de criação de pagamento/pre-autorização.
O Carat aceita até 30 caracteres alfanuméricos, porém conforme regras documentadas nas integração com as adquirentes, este pode ser truncado para o tamanho especificado. O _soft-descriptor_ é um dado **opcional**.Atenção: Sugere-se que o lojista sempre valide com a adquirente o tamanho, formato e as condições de apresentação desta funcionalidade.
#
Roteamentos via SiTefCada roteamento via SiTef que aceita soft-descriptor possui um formato específico. O tamanho excedido do soft-descriptor recebido pelo Carat será removido.
Roteamento | Formato e Tamanho |
---|---|
Cielo | < AN 13 |
Stone | < AN 25 |
Getnet | < AN 22 |
Banrisul | < AN 22 |
Cabal | < AN 22 |
Rede | < AN 22 |
BIN | < AN 25 |
SiPAG | < AN 25 |
#
Roteamentos não-SiTef#
Cielo e-CommerceApenas para cartões Visa e Mastercard. O tamanho limite é de 13 caracteres alfanuméricos.
#
e-RedeO limite é de 13 caracteres alfanuméricos.
Exige a habilitação da função "identificação fatura" no cadastro da loja na e-Rede.
#
e.Rede RESTO limite é de 13 caracteres alfanuméricos para ser cadastrados no backoffice Carat ou enviados na requisição da transação.
São apresentados na fatura 8 caracteres estáticos que representam o estabelecimento, mais um asterisco *
, mais a parte dinâmica dos 13 caracteres citados acima.
Exemplo: nomeLoja*parteDinamica
Exige a habilitação da função "identificação fatura" no cadastro da loja na plataforma e.Rede REST.
#
Stone WSSe a transação for Visa, o limite é 25 caracteres;
Se a transação for Mastercard, o limite é 22 caracteres;
Se for parcelado, a Visa utiliza os 8 primeiros caracteres do nome do lojista pra passar a informação de parcelamento, sobrando 17 caracteres.
#
Getnet WSNo caso do lojista não cadastrar ou não enviar o soft-descriptor no Carat, a Getnet utilizará o nome fantasia do cadastro do Estabelecimento Comercial.
Este campo deve ser composto da seguinte forma:
- Identificação do Facilitador, com 3, 7 ou 12 caracteres
- Caractere de separação
*
(asterisco) - Identificação do subcomércio
O tamanho máximo é de 20 caracteres.
#
PayPalPara o PayPal, formato apresentado será o seguinte:
<PP *> ou <PAYPAL *><Nome Fantasia cadastrado nas preferências da loja na PayPal><espaço><soft-descriptor>
- Regras de caracteres permitidos para o campo soft descriptor:
- Caracteres alfanuméricos
- hífen
-
- asterisco
*
- ponto
.
- espaco
- Tamanho máximo de 22 caracteres para o texto totalizado.
Exemplo de uso:
- Prefixo definido como
PAYPAL *
nas configurações administrativas no PayPal; - O nome fantasia cadastrado nas configurações do lojista na PayPal é
EBAY
- O soft-descriptor passado via Carat é
Suzana Flores LTDA.
- O texto apresentado na fatura do portador do cartão será
PAYPAL *EBAY Suzana Fl
#
SafraPayPara o SafraPay, o campo soft descriptor permite um tamanho máximo de 22 caracteres, em que strings maiores enviadas nesse campo serão truncadas neste limite.
- São permitidos os seguintes caracteres:
- alfanuméricos em letra maiúscula e sem acento;
- % $ , . / & ( ) + = = < > - *
- Exemplo de campo válido:
LOS*POLLOS*HERMANOS*2
- Exemplos de campo inválidos:
los*pollos*hermanos
(letras minúsculas)MOE'S_BAR
(uso dos caractere especiais'
e_
)
O campo soft descriptor pode ser enviado nas seguintes transações:
- Crédito com Captura Tardia
- Crédito com Captura Automática
- Estorno de Transação
- Desfazimento de Transação
#
GlobalPaymentsWSPara a Global Payments, o soft descriptor deve conter um texto de até 13 caracteres que será impresso na fatura do portador, ao lado da identificação da loja, respeitando o comprimento das bandeiras:
- Visa: 25 caracteres
- Mastercard: 22 caracteres
[Nome da Loja] + [Asterico] + [Soft Descriptor] = [22 ou 25] caracteres
Na eventualidade da soma do nome da loja e soft descriptor exceder o limite de caracteres, o texto do soft descriptor será truncado da direita para esquerda. Lembrando ainda que o espaço em branco entre o nome da loja e o texto é contabilizado como 1 caractere.
Uso exclusivo de caracteres simples, sem acentuação e especiais.