feat(EWT-535): Support for merchant account transactions pagination

[dili91]

Description

Adds support for paginating merchant accounts transactions.
If not enabled at their client setting already, clients created before December 2023 have to explicitly opt-in with the help of an HTTP header as described on our public API documentation.

To do so, when using the Java library, those clients can use a new overload of the listTransactions API accepts an extra headers parameter:

// Clients created before December 2023
tlClient.merchantAccounts()
    .listTransactions(
            Headers.builder()
                    .enablePagination() //required to opt-in for pagination
                    .build(), 
            getMerchantAccount(CurrencyCode.GBP).getId(),
            ListTransactionsQuery.builder().from(from).to(to).build())
    .get();

Clients created from December 2023 onwards can use the existing, simpler variation of the listTransactions API:

// Clients created from December 2023
tlClient.merchantAccounts()
    .listTransactions(
            getMerchantAccount(CurrencyCode.GBP).getId(),
            ListTransactionsQuery.builder().from(from).to(to).build())
    .get();

Important

Note that for clients created before December 2023 that do not explicitly opt-in for the pagination feature, the use of the cursor query parameter will be ineffective, and the pagination object in returned responses will be always null.

Type of change

Please select multiple options if required.

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)
• This change requires a documentation update

Checklist:

• My code follows the style guidelines of this project
• I have performed a self-review of my own code
• I have commented my code where necessary
• I have added tests that prove my fix is effective or that my feature works
• I have updated the relevant documentation

[swarmia]

✅  Linked to Task EWT-535 · [java lib] Add pagination support to merchant account's transactions

[dili91]

I'm changing these defaults from and to values because pagination works only on more recent transactions.

[azanin]

great work!