Soft Descriptor

The soft-descriptor is an additional text that will be presented alongside the name of the establishment in the credit card invoice. This text can be defined in e-SiTef merchant configuration or in a payment/pre-authorization request.

In e-SiTef, the soft-descriptor format accepts up to 30 alphanumeric characters, but it can be truncated according to acquirer specified size. The soft-descriptor is an optional data.

Attention: We suggest that merchant always confirm the size, format and presentation conditions of soft-descriptor with acquirer

SiTef Rountings

Each SiTef that accepts soft-descriptor has a specific format. The soft-desciptor oversize received by e-SiTef will be removed.

RoutingFormat and Size
Cielo< AN 13
Stone< AN 25
Getnet< AN 22
Banrisul< AN 22
Cabal< AN 22
Rede< AN 22
BIN< AN 25
SiPAG< AN 25

Non SiTef Rountings

Cielo e-Commerce

Only for Visa and Mastercard cards. The size limit is 13 alphanumeric characters.

e-Rede

The maximum size is 13 alphanumeric characters.

Need to activate "invoice identification" at the e-Rede registration.

e.Rede REST

The maximum size is 13 alphanumeric characters, to be registered in e-SiTef backoffice or to be sent in transaction request.

The invoice will show 8 static characters that represent the merchant name, plus an asterik *, plus the dynamic part of 13 characters mentioned above.

Exemple: mercName*DynamicPart01

Need to activate "invoice identification" at the e.Rede REST registration.

Stone WS

If the transaction use Visa, the limit is 25 characters.

If the transaction use Mastercard, the limit is 22 characters.

If the transaction use installment with Visa, so the first 8 characters for installment information, resting 17 characters.

GetNet WS

If the merchant does not send or register the soft-descriptor in e-SiTef, Getnet will use the fantasy name of the Commercial Establishment registration.

This field is composed as following:

  • Facilitator ID, with 3, 7 or 12 characters
  • Separation character * (asterisk)
  • Submerchant ID

The maximum size is 20 characters.

PayPal

For PayPal, the presented format will be as shown above:

<PP *> or <PAYPAL *><Merchant descriptor as set in the PayPal Payment Receiving Preferences><1 space><soft-descriptor>

  • Character length and limitations:
    • Alphanumeric characters
    • dash -
    • asterisk *
    • period .
    • space
  • The maximum length of the soft descriptor is 22 characters.

For example:

  • The PayPal prefix toggle is set to PAYPAL * in PayPal’s administration tools.
  • The merchant descriptor set in the Payment Receiving Preferences is set to EBAY.
  • The soft descriptor is passed in e-SiTef as JanesFlowerGifts LLC.
  • The resulting descriptor string on the credit card invoice is PAYPAL *EBAY JanesFlow

SafraPay

For SafraPay, the soft descriptor field allows a maximum length of 22 characters, where larger strings sent in this field will be truncated at this limit.

  • The following characters are allowed:
    • alphanumeric in uppercase and unaccented;
    • % $ , . / & ( ) + = = < > - *
  • Valid field example: LOS*POLLOS*HERMANOS*2
  • Invalid field examples:
    • los*pollos*hermanos (lowercase characters)
    • MOE'S_BAR (use of special characters ' and _)

Soft descriptor field can be sent in the following transactions:

  • Credit with late confirmation
  • Credit with automatic confirmation
  • Transaction refund
  • Transaction undo

GlobalPaymentsWS

For Global Payments, the soft descriptor field allows a maximum length of 13 characters. This text will be printed alongside the merchant's identification, following the lengths of each brand:

  • Visa: 25 characters
  • Mastercard: 22 characters

[Merchant Name] + [Asterisk] + [Soft Descriptor] = [22 or 25] characters

In case the sum of these fields exceed the character limit, the soft descriptor text will be truncated from right to left. White spaces are counted as 1 character.

Only simple characters are allowed.

← API codesSignature authentication →