- Square Version:
InventoryAdjustment, InventoryPhysicalCount, and InventoryTransfer objects. Added the
team_member_idattribute to reference a seller's employee who is responsible for making the respective inventory changes.
Order object. After an order with a fulfillment is created, a seller can optionally split the fulfillment using Square products, such as the Seller Dashboard, the Point of Sale application, and Square Online websites. Until now, applications using the Orders API could could view all the fulfillments but could not determine which line item belong to which fulfillment. The Orders API now supports viewing and managing these fulfillments. OrderFulfillment objects returned in the
Order.fulfillmentsfield now contain new
line_item_applicationfields to enable applications to view which line items belong to which fulfillments. Applications can call RetrieveOrder to access an order and view fulfillments. Applications can also use UpdateOrder to update a specific order fulfillment.
If a payload includes an invalid or unrecognized field name, it is rejected and returns an
Afterpay Payments. The Payments API now supports Afterpay as a payment source. Applications using the Web Payments SDK can take Afterpay payment information from buyers and generate a payment token. Applications can then call
CreatePaymentto charge the payment token. Afterpay support is now available in the United States and Australia.
CreatePayment endpoint. Developers can now use this endpoint to record $0 payments of the CASH and EXTERNAL types. For example, suppose you create an order for $20 and apply a $20 discount. You then need to make a $0 payment to set the order state to COMPLETED. Prior to this release, developers used the Orders API (
PayOrderendpoint) to take $0 payments. For more information, see Orders integration.
OAuthPermission enum. Added the
MERCHANT_PROFILE_WRITEpermission required by the
TaxIds object. Added the NIF (Numero de Identificacion Fiscal) tax ID (beta) used for locations in Spain.
LoyaltyAccount object. The
enrolled_atfield is now writable in a
CreateLoyaltyAccountrequest. For more information, see LoyaltyAccount object.
This field can be set using any Square API version that supports the
CreateLoyaltyAccountendpoint. Starting on February 16, 2022, Square populates any undefined
enrolled_atfield with the timestamp of when the buyer first earned points or created a reward.
Merchants API Overview. Clarified the use of endpoints and the relationship between
Working with Addresses. Added information about addresses in Spain.
If you need more assistance, contact Developer Support or ask for help in the Developer Forums.