Updates to Trolley SDKs: Announcing New Packages Coming in May 2023

This is a friendly notice to our developer community, letting you know that you’ll need to update your SDK implementation by the end of 2023.


To help our customers integrate Trolley with ease, we provide many developer tools – including different Trolley SDKs which provide an easier way to access Trolley APIs.

To improve the coverage of Trolley APIs, and to adhere to the rebranding work we started in 2022, we are working to update all of our SDKs.

Note: The changes introduced by these updates will require you to make changes in your code.

These MAJOR updates will be launched with new package names starting May 2023.

The current packages will be deprecated after the launch (will not receive any new updates) and will be sunsetted starting in Q3 2023.

Here’s a rundown of the changes you’ll need to make in your code to migrate to the new packages:

  • Change the dependency/package URL.
  • Update the class references from “PaymentRails” to “Trolley”.
  • Some method names and their callbacks might need to be changed.
  • Update how “errors” and “exceptions” are handled.
  • Update pagination for some SDKs.

The following list provides more details about the release status and links to SDK-specific changelogs & update guides. Each link provides details required and the specific steps you’ll need to take on your end to update your implementations of the SDKs:

SDK NameStatusLearn More at
PHP SDKLivePHP SDK Changelog and Update Guide
Javascript SDKLiveJavascript SDK Changelog and Update Guide
Ruby SDKLiveRuby SDK Changelog and Update Guide
.Net SDKLive.Net SDK Changelog and Update Guide
Python SDKLivePython SDK Changelog and Update Guide
Java SDKLiveJava SDK Changelog and Update Guide
Status of SDK Updates (as of November 22, 2023)

In our first phase (May 2023), we’ll make updates to the PHP, Javascript, and Ruby SDKs. We’ll update this list with changelogs and update guides for our Python, .Net, and Java SDKs as they become available later in the year.

We’ll also tweet/post on LinkedIn when guides for other SDKs are ready. So keep an eye on this blog post, Twitter, & LinkedIn.

If you have any questions, please contact us at [email protected].

We know that these actions require work on your end and rest assured, we’re making this change to offer stable continued access to these SDKs in the long run. We look forward to continuing to provide you with the best experience possible.

All the best,

The Trolley Development Team

Share this article:

Join The Payouts Pulse

Sign up to have vital insights, industry news, and all things payouts delivered to your inbox monthly.

More to explore

Print Music Royalties: A Guide for Music Business Professionals

Print Music Royalties: A Guide for Music Business Professionals

This guide aims to help music business professionals looking to better understand…
Mastering the Art of Licensing Samples: A How-to Guide

Mastering the Art of Licensing Samples: A How-to Guide

Read to understand the complexities of managing the copyright, licensing, and royalty…
Sync Royalties: A Guide for the Streaming & Social Media Era

Sync Royalties: A Guide for the Streaming & Social Media Era

A guide to sync royalties—what they are, how they’re calculated, how they’re…
Understanding Payouts: How Are Performance Royalties Calculated and Reported?

Understanding Payouts: How Are Performance Royalties Calculated and Reported?

This guide serves as an entry point for those looking to understand…

Ready to get started?

To learn more about Trolley, schedule a demo with one of our team members or start a chat with a product expert by selecting the box on the bottom of your screen.