Current Status of Deprecated API Objects
Square API and Connect v1 API endpoints and fields can be deprecated, retired, and replaced by improved functionality provided by new replacement endpoints and fields. The Square developer platform keeps these code breaking changes to a minimum and only makes them when a critical new feature requires such a change. When an API object is deprecated and scheduled to be retired, Square provides a migration guide to give developers step-by-step guidance to update their code to use replacement objects.
The following endpoints are deprecated and currently scheduled for retirement, but the associated APIs are still generally available. For more information, see the associated migration guide or relevant Technical Reference entry.
| Endpoint name | Replacement | Deprecated | Retirement |
|---|---|---|---|
| RenewToken | OAuth.ObtainToken Migration guide | 2021-05-13 | 2022-05-13 |
| ListEmployees | ListTeamMembers Migration Guide | 2020-08-26 | 2021-08-26 |
| RetrieveEmployee | RetrieveEmployee Migration Guide | 2020-08-26 | 2021-08-26 |
| ListEmployeeWages | ListTeamMemberWages Migration Guide | 2020-08-26 | 2021-08-26 |
| GetEmployeeWage | GetTeamMemberWage Migration Guide | 2020-08-26 | 2021-08-26 |
| ListLoyaltyPrograms | RetrieveLoyaltyProgram Migration Guide | 2021-05-13 | TBD |
| CreateCustomerCard | CreateCard or LinkCustomerToGiftCard Migration Guide | 2021-06-16 | TBD |
| DeleteCustomerCard | DisableCard or UnlinkCustomerFromGiftCard Migration Guide | 2021-06-16 | TBD |
| ListSettlements | ListPayouts Migration Guide | 2019-11-15 | 2023-06-16 |
| RetrieveSettlement | GetPayout or ListPayoutEntries Migration Guide | 2019-11-15 | 2023-06-16 |
| CreateCheckout | CreatePaymentLink Migration Guide | 2022-08-17 | 2023-04-02 |
The following fields are deprecated and replaced:
If you need more assistance, contact Developer Support or ask for help in the Developer Forums.