2025-09-24 Changelog

Devices API

• New DeviceType enum - HANDHELD, representing the Square Handheld.
• New WifiDetails field - mac_address, representing the MAC address of the device on the network.
• New EthernetDetails field - mac_address, representing the MAC address of the device on the network.

Subscriptions API

• Subscription object:

  • New status enum - COMPLETED, representing a subscription with a fixed number of phases that has completed all billing cycles. Subscriptions with this status don't bill the customer and cannot be modified or resumed.
  • New completed_date field - The YYYY-MM-DD-formatted date on which the subscription is expected to complete all of its phases. After this date, the subscription status changes to COMPLETED and the subscription billing stops. If the subscription is for a plan variation that includes at least one phase that isn't fixed-length, it has no defined completion date and this field is unset.

• SubscriptionAction object:

  • New type enum - COMPLETE, the action marking when a subscription completes its fixed number of phases.

• Subscription Billing and Invoices - A new section documenting completed subscriptions.

Learn about versioning for the Square API and SDKs.