- Get Started
- Guides
- Integrations
- References
- API Reference
- Basic Payment
- Forex
- Authentication
- Card Account
- Apple Pay
- Virtual Account
- Bank Account
- Token Account
- Customer
- Billing Address
- Merchant Billing Address
- Shipping Address
- Merchant Shipping Address
- Merchant
- Corporate
- Recipient
- Marketplace & Cart
- Airline
- Lodging
- Passenger
- Tokenization
- Recurring Migration
- 3D Secure
- Custom Parameters
- Async Payments
- Webhook notifications
- Job
- Risk
- Point of Sale
- Response Parameters
- Card On File
- Chargeback
- Result Codes
- Payment Methods
- Transaction Flows
- Regression Testing
- Data Retention Policy
- API Reference
- Support
![Home](https://paynt-email-signature-images.s3.eu-west-1.amazonaws.com/Paynt-logotype_167x60px-30.png)
Transaction Reports
Transaction reports allow to retrieve detailed transactional data from the platform. The information retrieved is related to the transactions being processed by the system and can be filtered using different filter parameters and options. Click on the links to navigate to the right option for your use case.
Get transaction by id
The payment identifier id
is the identifier generated by the system. It is unique per transaction
and can be used to get information on a specific transaction.
If this identifier is available it can be used to query the platform by adding it directly in URL. For example:
![](/sites/default/files/ajax-loader.gif)
Advanced options
Additional parameters are available to make requests with advanced filtering and returning all transactions linked to the original one. The following parameters can be used:
includeLinkedTransactions
- If set totrue
, the query returns all transactions linked to the original (default value isfalse
)paymentTypes
- this parameter is used to filter the response and return only the specified payment types, for examplepaymentTypes=PA,CP,RV
paymentMethods
- this parameter is used to filter the response and return only the specified payment methods, for examplepaymentMethods=CC,DC
Please see the API Reference for a full list of possible values.
Example:![](/sites/default/files/ajax-loader.gif)
Get transaction using short Id
The payment identifier shortId
is the identifier generated by the system. It is unique per transaction and can be used to get information for a specific transaction. The merchantTransactionId
or date.from
and date.to
parameters are mandatory to
be added along with shortId to the request.
To query the system and get the transaction related to shortId
, add it
as query parameter as follows:
![](/sites/default/files/ajax-loader.gif)
Get transaction using your order reference
An order can involve multiple transactions in the platform (e.g. PA, CP, 3D, ...). The parameter merchantTransactionId
, as a best practice, should be used in all transactions as order identifier. For this reason it can be also used to query and get all the transactions for a specific order. From the response
of this query more than one entry is expected.
To query the system and get all the transactions related to a single merchantTransactionId
, add it
as query parameter as follows:
![](/sites/default/files/ajax-loader.gif)
Get transactions for a specified time frame
To retrieve a list of transactions for a specified time frame it is possible to add the date.from
and date.to
parameters to the request. To limit the number of entries returned for a request use the parameter limit
(min: 100 ma: 500).
If the parameter
Additionally, it is still possible to filter the result using limit
is omitted in the request, the default value of 100 will be used and, depending on the number of results, pagination will be used.
paymentTypes
and paymentMethods
filtering options.
Request must contain either parameters. Please see the API Reference for further details.
merchantTransactionId
or date.to
/date.from
and ![](/sites/default/files/ajax-loader.gif)
How to use pagination
Since the number of records returned by quering for a specific timeframe can be considerable, this endpoint implements pagination. To use pagination, specify the page number in the parameter pageNo
.
In all requests with pagination the option
limit
is ignored and the page size is by default set to 100.
![](/sites/default/files/ajax-loader.gif)