Get your merchant account transactions or payment sources

We call payments into or out of a merchant account transactions.

Get a list of transactions

Make a GET call to the /v3/merchant-accounts/{id}/transactions endpoint, and additionally include the following parameters to state an interval for the list:

• from: Timestamp as a string for the start of the range you are querying.
• to: Timestamp as a string for the end of the range you are querying.

The following example shows what the URI can look like:

/v3/merchant-accounts/{id-of-account}/transactions?from=2021-11-02T00%3A00%3A00.000Z&to=2021-11-10T23%3A59%3A59.599Z

Difference between transaction and payment IDs

If a merchant account transaction wasn't initiated through TrueLayer, the transaction won't have an associated payment ID.

A payment into a merchant account always has a transaction ID associated with it in the system. Note that the transaction ID returned from a transaction resource is unique and not the same as a payment ID.

📘

Payouts

This does not apply to payouts. The payout ID and the ID of the associated transaction are identical.

Retrieve payment sources for a merchant account

You can use the /v3/merchant-accounts/{id}/payment-sources endpoint to retrieve all of the payment sources that have paid into a merchant account.

In the response, this endpoint returns the following information for each payment source:

• The payment source id, which you can use to initiate a closed-loop payout.
• The name of the account holder.
• The account identifier, or payment details, used for the payment.