- Square Version:
OrderLineItemPricingBlocklists. You can explicitly specify taxes and discounts in an order or automatically apply preconfigured taxes and discounts to an order. In addition, you can now block applying these taxes and discounts to a specific OrderLineItem in an order. You add the
pricing_blocklistsattribute to individual line items and specify the
blocked_taxesthat you do not want to apply. For more information, see Apply Taxes and Discounts. For example walkthroughs, see Automatically Apply Discounts and Automatically Apply Taxes.
OrderPricingOptions. Previously, the
pricing_optionsfield in an order supported only
auto_apply_discountsto enable the automatic application of preconfigured discounts. Now it also supports
auto_apply_taxesto enable the automatic application of preconfigured taxes. For more information, see Automatically apply preconfigured catalog taxes or discounts.
OrderLineItemTax. It now includes the new
auto_appliedfield. It indicates whether the tax was automatically applied using a preconfigured CatalogTax.
The CancelBooking endpoint supports canceling an accepted or pending booking.
The booking.created webhook event notifies when a new booking is created by calling the CreateBooking endpoint.
The booking.updated webhook event notifies when an existing booking is updated.
ListCatalog, RetrieveCatalogObject, and BatchRetrieveCatalogObjects now support the
catalog_versionfilter to return catalog objects of the specified version.
SearchCustomers endpoint. The
reference_idquery filters are now generally available (GA).
The AddGroupToCustomer endpoint is now GA.
The RemoveGroupFromCustomer endpoint is now GA.
The Customer Groups API is now GA.
The Customer Segments API is now GA.
Invoices API: (beta)
Invoice object. Added the
custom_fieldsfield, which contains up to two customer-facing, seller-defined fields to display on the invoice. For more information, see Custom fields.
As part of this change, the following objects are added:
InvoiceRequestMethod enum. Added the read-only CHARGE_BANK_ON_FILE value, which represents a bank transfer automatic payment method for a recurring invoice.
Loyalty API: (beta)
LoyaltyProgramRewardTier object. The
definitionfield in this type is deprecated and replaced by the new
pricing_rule_referencefield. You can use
pricing_rule_referencefields to retrieve catalog objects that define the discount details for the reward tier. For more information, see Get discount details for a reward tier.
As part of this change, the following objects are deprecated:
Square Node.js SDK:
The new Square Node.js SDK is now GA and replaces the deprecated Connect Node.js SDK. The Connect Node.js SDK entered the security maintenance phase on 2020-12-16. For migration information, see the Connect SDK README.
Get Right-Sized Permissions with Down-Scoped OAuth Tokens. This new OAuth API topic shows how to get an additional reduced-scope OAuth token with a 24-hour expiration by using the refresh token from the Square account authorization OAuth flow.
If you need more assistance, contact Developer Support or ask for help in the Developer Forums.