For card payments, you can optionally specify
statement_description_identifier in a
CreatePayment request. This topic explains how Square uses this identifier in constructing statement descriptions that it sends to banks.
Square sends statement description information for payments that Square processes on behalf of the seller, per bank requirements. This information then appears on customer card or bank statements when they make or receive payments.
Clear and accurate statement descriptions explain charges and payments and can help reduce the risk of chargebacks and disputes. Bank and card network rules require that statement descriptions clearly indicate the business responsible for the charge or payment, in addition to providing other details to help customers understand their statements.
This is an example statement description:
The general format of a statement description that banks include on a customer card or bank statement is as follows:
- Payment-facilitator-id - For Square-generated descriptors, this value is
- Business name - This is the business name shown in the Seller Dashboard. A seller configures this information as part of the business receipt configuration in the Seller Dashboard.
- Delimiter - This is the required delimiter. Square adds this only if you provide the identifier.
- Identifier (optional) - The preceding example shows a pharmacy store number (
#02943) as the identifier. If a
CreatePaymentrequest includes the statement_description_identifier, Square uses the value as the identifier.
Payment object stores this information in the card_detail.statement_description field. Note that this information isn't guaranteed to be exactly what the buyer sees for the following reason:
- In constructing a statement descriptor, after
Payment-facilitator-id, Square is limited to 20 characters. Accordingly, Square truncates the identifier portion as needed.
- The statement description that Square sends to the card networks can be further truncated before being displayed to the cardholder.