2024-02-22 Changelog

Catalog API: Added text-based modifiers (Beta) to support text-based product customization at the time of sale.

• CatalogModifierList object - Added the following attributes:
  • modifier_type
  • max_length
  • text_required
  • internal_name
• CatalogModifierListInfo object - Added the ordinal attribute.
• CatalogModifierListModifierType enum - Added to support the selection of list-based or text-based modifiers.

For more information, see Enable Product Customization with Modifiers.

Customers API: Added endpoints that allow you to retrieve or manage 1–100 customer profiles in a single call:

• BulkCreateCustomers
• BulkUpdateCustomers
• BulkDeleteCustomers
• BulkRetrieveCustomers

For more information, see Manage Customer Profiles and Retrieve Customer Profiles.

Payouts API: Added payout entry types for the ListPayoutEntries endpoint:

• LOCAL_OFFERS_CASHBACK
• LOCAL_OFFERS_FEE
• PERCENTAGE_PROCESSING_ENROLLMENT
• PERCENTAGE_PROCESSING_DEACTIVATION
• PERCENTAGE_PROCESSING_REPAYMENT
• PERCENTAGE_PROCESSING_REPAYMENT_REVERSED
• PROCESSING_FEE
• PROCESSING_FEE_REFUND
• UNDO_PROCESSING_FEE_REFUND
• GIFT_CARD_LOAD_FEE
• GIFT_CARD_LOAD_FEE_REFUND
• UNDO_GIFT_CARD_LOAD_FEE_REFUND
• BALANCE_FOLDERS_TRANSFER
• BALANCE_FOLDERS_TRANSFER_REVERSED
• GIFT_CARD_POOL_TRANSFER
• GIFT_CARD_POOL_TRANSFER_REVERSED

For more information, see Payout type details.

Webhook Subscriptions API: For CreateWebhookSubscription or UpdateWebhookSubscription requests with read-only fields specified in the request body, a 400 bad request error is now returned. In earlier Square API versions, read-only fields are ignored.

Catalog API:

• Enable Product Customization with Modifiers topic - Added a topic that demonstrates how to enable product customization with previously released list-based modifiers as well as newly released text-based modifiers.

Refunds API:

• PaymentRefund object - Added SQUARE_ACCOUNT as a destination_type value.

Subscriptions API:

• price_override_money field - Clarified that this field doesn't affect itemized subscriptions with RELATIVE pricing. Relative prices are controlled by the subscription's order template.