2021-01-21 Changelog

Square Invoices API Locations API Documentation

Version Summary

• Square Version: 2021-01-21
• Java: 8.1.0.20210121
• .NET: 8.1.0
• Node.js: 8.1.0
• PHP: 8.1.0.20210121
• Python: 8.1.0.20210121
• Ruby: 8.1.0.20210121

Details

Link to section

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 returned Invoice 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.

Link to section

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.

Link to section

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 code examples.