---
title: "Retrieve transactions for payment id"
method: GET
path: "/acquiring/transaction/v3.0/acquirers/{acquirerId}/payments/{paymentId}/transactions"
tags: ["Transaction"]
---

# Retrieve transactions for payment id

`GET /acquiring/transaction/v3.0/acquirers/{acquirerId}/payments/{paymentId}/transactions`

## Request

- Base URL: `https://financial-services.developer.worldline.com/MerchantApiTransaction/api`
- URL: `https://financial-services.developer.worldline.com/MerchantApiTransaction/api/acquiring/transaction/v3.0/acquirers/{acquirerId}/payments/{paymentId}/transactions`
- Auth: none declared

This operation uses the paymentId to retrieve the associated transaction(s) data.

If there is a previous and/or next page the http response header will have a link (url) to this data. See https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/Link#pagination_through_links

## Path parameters

- `acquirerId` string, required
- `paymentId` string, required

## Query parameters

- `paymentDate` string, date, required
- `transactionAmountFrom` number, double
- `transactionAmountTo` number, double
- `transactionAmountCurrency` string
- `sortField` 'TransactionId' | 'TransactionDateTime' | 'TransactionType' | 'Brand' | 'TruncatedPan'
- `sortOrder` 'Ascending' | 'Descending'
- `pageSize` string
- `pageNumber` string

## Response `200`

Successful

- Transaction[]
  - `transactionIdentification` TransactionIdentification
    - `transactionId` string: Unique identification for a Cardholder Initiated Transaction
    - `actionId` string: Action ID in UUID format
    - `acquirerReferenceNumber` string: Data supplied by an acquirer to assist in identifying a transaction, e.g. for researching retrievals and chargebacks
    - `merchantReference` string: Merchant Reference. This is a reference that the merchant can add to an authorization request towards the terminal by entering it via the keyboard of the merchant.
    - `pspReference` string: Additional information provided by the concentrator to return on his statement.
    - `retrievalReferenceNumber` string: External retrieval reference number.
    - `stan` integer: Systems Trace Audit Number
  - `contractIdentification` ContractIdentification
    - `acquirerId` string: Unique identification of the acquirer, determined by equensWorldline
    - `pspId` string: Psp Id
    - `holdingId` integer: Unique identification of the holding, determined by equensWorldline
    - `merchantId` string: Unique identification of the merchant, determined by the acquirer
    - `contractId` string: Unique identification of the contract, determined by the acquirer
    - `cardAcceptorId` string: Unique identification of the cardAcceptor within the contract
    - `siteId` integer: Unique identification of the site within the contract
    - `terminalId` string: Unique code identifying the terminal at the Card acceptor location
  - `approvalCode` string: Code assigned by the authorising institution indicating approval
  - `brand` string: Unique identification of the brand (payment product). Maestro MAES, Visa VISA, etc.
  - `cardAcceptorNameLocation` string: The name and place where the terminal is located. Note - A backslash is not valid json. So a backslash will be escaped (with a backslash)
  - `channel` integer: Channel code (0 atm, 1 pos, 2 eCommerce, 3 moto)
  - `contactlessIndicator` integer: Indicates whether the transaction has been done contactless (0 no, 1 yes)
  - `creditDebitIndicator` string: Funding source. The field describes how the cardholder funds his account. (C = Credit, D = Debit, P = Prepaid)
  - `forwardingInstitutionId` string: Code identifying the acquirer processor or card acceptor
  - `matStatus` string: MAT transactions are flagged as MAT so that acquirer and merchant can see the transaction was approved in back-up mode. Values ​​0 (No MAT) or 1 (Approved MAT).
  - `merchantCategoryCode` integer: Merchant Catogory Code
  - `paymentFacilitatorId` string: Identifier for a Payment Facilitator which allows anyone who wants to offer merchant services on a sub-merchant platform.
  - `paymentInfo` PaymentData[]
    - `merchantPaymentId` string: Unique identification of the payment in which this transaction has been paid out
    - `merchantPaymentAggregationLevelCode` string: Code for the merchant payment aggregation level.
    - `paymentType` string: Type for which payment created. Transaction Fee, Transaction
    - `paymentDate` string, date-time: payment date (yyyy-mm-ddT00:00:00+01:00) (Note, time always 00:00:00+hh:00)
    - `paymentCrossReferenceURI` string: URI to the MerchantApiPayment to get the payment that belongs to this transaction. Only available if there is a payment date.
  - `paymentProductTypeCode` string: Code for the type of payment product. (Z Commercial Card. 2 Consumer Card)
  - `posEntryMode` string: A code that identifies how the carddata was entered on the terminal and which PINentry capabilities the terminal possesses.
  - `pricePlanTarifId` string: Unique identification for the price plan tarif.
  - `processingDateTimeScheme` string, date-time: processing date-time by scheme (RFC 3339)
  - `region` string: Region of the payment scheme (Netherlands Maestro, etc)
  - `regionCode` string: Region of the payment scheme code
  - `subMerchantId` string: Sub Merchant ID, defined by a Payment Facilitator (merchant). Each merchant that is considered to be a “Payment Facilitator” by MasterCard needs to uniquely identify all of its sites with a sub merchant ID
  - `terminalBatchReference` string: Reference of the terminal batch
  - `terminalProtocol` string: Terminal Protocol
  - `transactionDateTime` string, date-time: authorisation date-time (RFC 3339)
  - `transactionDescription` string: Transaction currency combination description
  - `transactionFeePricePlanTypeCode` string: Type of Merchant transaction fee price plan code. (00 No price plan type, 01 Standard pricing, 02 Interchange plus, 03 Advanced pricing)
  - `transactionLevel` string: Code that identifies the transaction level
  - `transactionStatus` string: Status of the transaction (CAPT transaction is captured, TFEE transaction fee is added, PAID transaction is paid out)
  - `transactionType` string: Description of transaction being undertaken
  - `transactionTypeCode` string: Code which indicates the type of transaction being undertaken. Used in conjunction with the Account type code as part of the Processing code. (Most common codes are the following: 904 Purchase Presentment, 905 Cash Withdrawal/Advance Presentment, 901 Refund Presentment, 047 Reimbursement Equens Merchant Loss Settled Debit, 024 Adjustment (Corrections or Manual Adjustments) Correction, etc.)
  - `truncatedPan` string: truncated pan. Only the first 6 and last 3 digits are present. Values inbetween are zeros
  - `vatLabel` string: Describes the rate of the VAT
  - `result3ds` string: Indicates result of the 3-D Secure authentication process.
  - `version3ds` string: Indicates the applied 3-D Secure version.
  - `cavv` string: CAVV (Cardholder Authentication Verification Value) data in hexadecimal notation (40 characters for 20 bytes).
  - `xid` string: XID (eCommerce transaction ID) in hexadecimal notation (40 characters for 20 bytes).
  - `ucaf` string: UCAF (Universal Cardholder Authentication Field) in hexadecimal notation (40 characters for 20 bytes).
  - `mitCause` string: Cause detailing the Merchant Initiated Transaction.
  - `initiatorType` string: Indicates which entity has triggered the operation.
  - `captureSequenceNumber` integer: Number of current capture in the entire capture sequence starting from 1.
  - `captureSequenceCount` integer: Total number of captures for the business case in case BusinessCaseType is FinancialRequest.
  - `schemeMerchantId` string: Id for the merchant assigned by the card scheme
  - `schemeTransactionId` string: The Trace-ID/TID assigned by the scheme
  - `paymentInitiationChannel` string: Used to provide information about the form factor of the token that was used to initiate a payment
  - `paymentAccountReference` string: this is a unique reference value that is assigned to a single PAN to link the Payment Account to its associated tokens. The PAR is made of 29 unique alphanumeric characters and does not change throughout the PAN’s lifecycle event
  - `tokenAssuranceMethod` string: this is the outcome of the token assurance steps and represents the confidence level of the token to the PAN/cardholder binding. These numbers range between 01 and 99 and can be divided into three categories. The first category ranges between 01 and 19. The second category ranges between 20 and 89. The third category ranges between 90 and 99
  - `tokenRequestorId` string: this identifies each unique combination of Token Requestor and Token Domain(s) for a given Token Service Provider. It is possible for the the merchant to have multiple token requestor IDs to support different usage scenarios
  - `transactionAmount` Amount
    - `amount` string, unlimited size decimal: Amount in the major units of the currency according to ISO 4217. In case of euro, "3.10" (is 3.10 euro)
    - `currency` string: Currency of the amount
  - `transactionVatAmount` Amount
    - `amount` string, unlimited size decimal: Amount in the major units of the currency according to ISO 4217. In case of euro, "3.10" (is 3.10 euro)
    - `currency` string: Currency of the amount
  - `merchantTransactionFeeAmount` Amount
    - `amount` string, unlimited size decimal: Amount in the major units of the currency according to ISO 4217. In case of euro, "3.10" (is 3.10 euro)
    - `currency` string: Currency of the amount
  - `merchantTransactionFeeVatAmount` Amount
    - `amount` string, unlimited size decimal: Amount in the major units of the currency according to ISO 4217. In case of euro, "3.10" (is 3.10 euro)
    - `currency` string: Currency of the amount
  - `netAmount` Amount
    - `amount` string, unlimited size decimal: Amount in the major units of the currency according to ISO 4217. In case of euro, "3.10" (is 3.10 euro)
    - `currency` string: Currency of the amount
  - `schemeMarkupAmount` Amount
    - `amount` string, unlimited size decimal: Amount in the major units of the currency according to ISO 4217. In case of euro, "3.10" (is 3.10 euro)
    - `currency` string: Currency of the amount
  - `interchangeFeeAmount` Amount
    - `amount` string, unlimited size decimal: Amount in the major units of the currency according to ISO 4217. In case of euro, "3.10" (is 3.10 euro)
    - `currency` string: Currency of the amount
  - `cashBackAmount` Amount
    - `amount` string, unlimited size decimal: Amount in the major units of the currency according to ISO 4217. In case of euro, "3.10" (is 3.10 euro)
    - `currency` string: Currency of the amount
  - `acquirerMarkupAmount` Amount
    - `amount` string, unlimited size decimal: Amount in the major units of the currency according to ISO 4217. In case of euro, "3.10" (is 3.10 euro)
    - `currency` string: Currency of the amount
  - `merchantTransactionAmount` Amount
    - `amount` string, unlimited size decimal: Amount in the major units of the currency according to ISO 4217. In case of euro, "3.10" (is 3.10 euro)
    - `currency` string: Currency of the amount

## Other responses

- `400`: Invalid input provided
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Resource not found
- `500`: Unexpected error or Internal error
- `502`: Backend service problem

---

[API](https://skmtc.dev/worldline/apis/merchant-payments-transactions-api.md) - [All operations](https://skmtc.dev/worldline/apis/merchant-payments-transactions-api/llms.txt) - [OpenAPI document](https://skmtc.dev/worldline/apis/merchant-payments-transactions-api/revisions/409c9f008803?raw)