Version 8.1.0.20210121 (2021-01-21T00:00)
Existing API updates
-
Invoices API: (beta)
The
InvoicePaymentRequest.request_method
field is deprecated, and its current options are separated into two new fields that better represent their scope:Invoice.delivery_method
specifies how Square should send invoices, reminders, and receipts to the customer.InvoicePaymentRequest.automatic_payment_source
specifies the payment method for an automatic payment.
As part of this change, the InvoiceDeliveryMethod and InvoiceAutomaticPaymentSource enums are added and the
InvoiceRequestMethod
enum is deprecated.The Invoices API will continue to accept
request_method
in create and update requests until the field is retired, but starting in this version,request_method
is not included in returnedInvoice
objects. For more information, see the migration notes. -
Locations API:
- The Locations.MCC field is now updatable (beta). You can use the
UpdateLocation
endpoint to update the merchant category code (MCC) associated with a seller location. For more information, see Initialize a merchant category code.
- The Locations.MCC field is now updatable (beta). You can use the
SDKs
-
Connect Node.js SDK: (deprecated)
The deprecated Connect Node.js SDK is in the security maintenance state. It will not receive any bug fixes or API updates from the Square version 2021-01-21 release. However, the SDK will receive support and security patches until it is retired (EOL) in Q2, 2021. For more information, including steps for migrating to the Square Node.js SDK, see the Connect SDK README.
Documentation updates
-
Catalog API:
- The Use Item Options to Manage Item Variations topic is added. It demonstrates how item variations are usually used and how item options can be used to enable random access to item variations.
-
Inventory API:
- The Inventory API content is updated. It provides clearer guidance about how to use the API, with a task-oriented TOC and improved cod