--- title: "Retrieve by AcquirerRefNo" method: GET path: "/acquiring/transaction/v3.0/acquirers/{acquirerId}/transactionlifecycle" tags: ["Transaction Lifecycle"] --- # Retrieve by AcquirerRefNo `GET /acquiring/transaction/v3.0/acquirers/{acquirerId}/transactionlifecycle` ## 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}/transactionlifecycle` - Auth: none declared - TypeScript: (a function with typed inputs; its response is checked against the schema) This operation uses the unique AcquirerRefNo (acquirerReferenceNumber ARN) to retrieve the associated first/second presentment(s) data \nand the associated transaction data of the different stages in the dispute life cycle. 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 ## Query parameters - `acquirerRefNo` string, 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 - Lifecycle[] - `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: Brand - `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 - `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) - `posEntryModeClearing` 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. - `processingDateScheme` 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, 030 Adjustment (Corrections or Manual Adjustments) Paid debt, 038 Adjustment (Corrections or Manual Adjustments) Fee 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 - `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)