2022-09-21 Changelog

Gift Card Activities API:

• GiftCardActivityAdjustDecrementReason enumeration. Added the PURCHASE_WAS_REFUNDED reason. This reason applies when using an ADJUST_DECREMENT activity to decrease the gift card balance after refunding an order that was used to purchase or reload the gift card.

Invoices API:

• Invoice object. Added the store_payment_method_enabled field. This field enables customers to choose to save a card on file or bank account on file from the invoice payment page.

OAuth API:

• ObtainToken endpoint. The following fields are removed from the response:
  • app_subscription_id
  • app_plan_id

Connect V1 APIs:

• In the Connect V1 API, some of the deprecated endpoint names conflict with similar names in the Square API. For that reason, the following Connect V1 endpoints have been renamed:

  API	Old endpoints	New endpoints
  Payments	ListPayments RetrievePayment	V1ListPayments V1RetrievePayment
  Refunds	ListRefunds CreateRefund	V1ListRefunds V1CreateRefund
  Settlements	ListSettlements RetrieveSettlement	V1ListSettlements V1RetrieveSettlement
  Webhooks	ListWebhooks UpdateWebhooks	V1ListWebhooks V1UpdateWebhooks

  These endpoints are for backward compatibility only. Square strongly discourages using Connect V1 APIs in most cases.

Various APIs:

• Support for null field clearing is now available for the following API objects:
  • Customer
  • Order
  • Location
  • Invoice
  • Subscription
  • TeamMember
  • Vendor

• is_valid_webhook_event_signature method. Added for webhooks signature validation. For the code sample, see Webhook event notification validation - Python.