What is Soft Descriptor

Soft Descriptor is a tag that will appear on the cardholder’s statement and helps the cardholder identify the transaction and helps avoid unnecessary calls by the cardholder to their issuer to help identify the transaction. You can find more information here under the Statement Descriptor section

📘
Ask TabaPay
Consult with your TabaPay representative for Card Acceptor Name values.

How to Set the Soft Descriptor

Soft Descriptor can be configured across all your transactions at the time of Onboarding (Static value) Soft Descriptor can also be configured at transaction time in TabaPay's Unified API (Dynamic value)

👍
Transaction Overrides Require Permission
When clients require overrides of the soft descriptor at transaction time, it will require a permission from TabaPay's compliance teams.

Remember to be fully compliant when configuring card acceptor values.

📘
Data Integrity Issues
When soft descriptors are provided during transaction-time, TabaPay requires our clients to ensure that the value follows guidelines below.
Networks consider it non-compliant when the State and ZIP Code do not match. Please ensure that the State and ZIP Code values are valid and match.

Restricted Characters

Soft descriptors are very sensitive and presence of bad characters or absence of requirements will result in declines.

The use of these characters within the name fields are explicitly restricted.

Forbidden Character	Character Description
`,`	Comma
`"`	Double Quotes
`~`	Tilde
`!`	Exclamation Point
`$`	Dollar Sign
`%`	Percentage
`&`	Ampersand
`()`	Parenthesis
`>`	Greater & less than
`:`	Colon
`;`	Semicolon
`[]`	Brackets
`{}`	Curley Brackets
`?`	Question mark
`/`	Slash
	Backslash
`^`	Caret
`\|`	Pipe
`@`	at
`#`	hash

Allowed Characters

Details for allowed characters are in the following Visa, Mastercard, American Express, and Discover guidelines.

📘
Guidelines are Subject to Change
This documentation is a reference, reflecting what is currently known. These guidelines may change in the future.

Visa Guidelines

Card Acceptor Name/Location, pos. 1-40 Length: 40 Format: 40 ANS

Card-present transactions will require the location of the merchant outlet as the location where the transaction took place.

Card-not-present transactions must contain the merchant’s customer service telephone number, the merchant’s universal resource locator (URL) or internet/e-mail address.

Field	Guidelines
Card Acceptor Name for Payouts	Earned Wage Access (Employer Based): EWA Provider Name_Employer Name Earned Wage Access (Direct to Consumer): EWA Company Name Insurance Payouts: Insurance Company Name Gambling Payouts: Casino Name or Payout Facilitator_Casino Name Marketplace Payouts: Marketplace Name P2P: P2P Brandname_Sender Name P2P (FI Initiated): P2P Brandname_Sender Name P2P (Processing Platforms): P2P Brandname_Sender Name Account-to-Account (non-FI, excluding brokerages): A2A Service Provider_Account Owner Name Account-to-Account (NeoBanks): Merchant Name/Brand Name_Account Owner Name Account-to-Account (Cash deposit): Merchant Name_Account Owner Name
Card Acceptor Name for Account Funding	Money Transfer Format (includes P2PA2A, Funds Transfers, Wallet Transfers, Business Initiated: **The Card Acceptor Name field must contain the "Doing Business As" name or abbreviation of th merchant (1-4 characters) and be the name most recognizable to the cardholder in addition to therecipient's name. The Merchant Name field must cotain the full Merchant Name or conform to this format whe including a recipient name: Format Field Position Data Pos. 1-4: Merchant Name (abbreviated) Pos. 5: Asterisk () Pos. 6-25: Recipient Name (optional, but recommended)

Field

Guidelines

Card Acceptor Name for Payouts

Earned Wage Access (Employer Based): EWA Provider Name_Employer Name Earned Wage Access (Direct to Consumer): EWA Company Name Insurance Payouts: Insurance Company Name Gambling Payouts: Casino Name or Payout Facilitator_Casino Name Marketplace Payouts: Marketplace Name

*P2P:
*P2P Brandname_Sender Name
*P2P (FI Initiated):
*P2P Brandname_Sender Name
*P2P (Processing Platforms):
*P2P Brandname_Sender Name
*Account-to-Account (non-FI, excluding brokerages):
*A2A Service Provider_Account Owner Name
*Account-to-Account (NeoBanks):
*Merchant Name/Brand Name_Account Owner Name
*Account-to-Account (Cash deposit):
*Merchant Name_Account Owner Name

Card Acceptor Name for Account Funding

Money Transfer Format (includes P2PA2A, Funds Transfers, Wallet Transfers, Business Initiated: **The Card Acceptor Name field must contain the "Doing Business As" name or abbreviation of th merchant (1-4 characters) and be the name most recognizable to the cardholder in addition to therecipient's name. The Merchant Name field must cotain the full Merchant Name or conform to this format whe including a recipient name: Format Field Position Data Pos. 1-4: Merchant Name (abbreviated) Pos. 5: Asterisk () Pos. 6-25: Recipient Name (optional, but recommended)

MasterCard Guidelines

Delimiter fields must be the blank character. This is required because most cardholder statement rendering systems in operation today are not designed to perform printer output editing or formatting of the acquirer-supplied data in soft descriptor.

American Express Guidelines

Field	Guidelines
Card Acceptor Name	Alphanumeric - Please do not use special characters. Blank spaces and periods are allowed for use.

Discover Guidelines

Field	Guidelines
Card Acceptor Name	Alphanumeric - Please do not use special characters. Blank spaces and periods are allowed for use.