Onerway
POST

Query transactions

View as Markdown
Use this endpoint to retrieve transaction records for reconciliation, chargeback handling, and reporting at the transaction-record level.

Request

merchantNostringrequired
Merchant number assigned by Onerway. See Setup for how to obtain it.
Example:replace_with_merchant_no
merchantTxnIdsstringConditional
Condition: Provide this field as one query condition. At least one of merchantTxnIds, transactionIds, or startTime + endTime is required.
Comma-separated merchant transaction numbers used to query transactions in batch.
Example:txn_demo_202606210001,txn_demo_202606210002
Constraints
Range
10IDsA single request can include up to 10 comma-separated IDs.
transactionIdsstringConditional
Condition: Provide this field as one query condition. At least one of merchantTxnIds, transactionIds, or startTime + endTime is required.
Comma-separated Onerway transaction IDs used to query transactions in batch.
Example:2031908578000000000,2031908578000000001
Constraints
Range
10IDsA single request can include up to 10 comma-separated IDs.
startTimestringConditional
Condition: Required together with endTime when querying by time range. At least one of merchantTxnIds, transactionIds, or startTime + endTime is required.
Start of the query time range, filtered by transaction creation time, in yyyy-MM-dd HH:mm:ss format.
Example:2026-06-01 00:00:00
Constraints
Rule
The maximum range between startTime and endTime is 90 days.
endTimestringConditional
Condition: Required together with startTime when querying by time range.
End of the query time range, in yyyy-MM-dd HH:mm:ss format.
Example:2026-06-21 23:59:59
Constraints
Consistency
endTime must be later than startTime.
Rule
The maximum range between startTime and endTime is 90 days.
txnTypesstringoptional
Transaction types used to filter results. Submit multiple values as a comma-separated string. When omitted, Onerway returns all transaction types.
Example:SALE,AUTH,REFUND
Allowed values
SALE
Payment transaction.
AUTH
Authorization transaction.
REFUND
Refund transaction.
currentstringrequired
Query page number. 0 and 1 both mean the first page. The response current value is always returned as a 1-based page number.
Example:1
sizestringoptional
Page size. The current endpoint returns 10 records per page and does not support a custom page size.
Example:10
signstringrequired
Request signature string. See Request signing for how to generate it.

Request example

curl -X POST 'https://sandbox-acq.onerway.com/v1/txn/list' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "merchantNo": "replace_with_merchant_no",
  "transactionIds": "replace_with_transaction_id",
  "current": "0",
  "sign": "{{SIGN}}"
}'

Response

respCodestring
20000 means the query request was processed successfully. It does not mean each transaction has succeeded. Other values are error codes. See Response codes.
respMsgstring
Human-readable message for the response code.
Business data object containing transaction records and pagination information.

Response example

{
  "respCode": "20000",
  "respMsg": "Success",
  "data": {
    "content": [
      {
        "transactionId": "replace_with_transaction_id",
        "paymentId": "replace_with_payment_id",
        "merchantTxnId": "example_merchant_transaction_id",
        "merchantTxnOriginalId": null,
        "txnTime": "2026-01-15 10:30:00",
        "txnTimeZone": "+08:00",
        "txnCompletionTime": "2026-01-15 10:30:30",
        "originTransactionId": null,
        "productType": "CARD",
        "subProductType": "DIRECT",
        "txnType": "SALE",
        "status": "S",
        "contractId": null,
        "tokenId": null,
        "userPaymentStatus": null,
        "cardType": "AE",
        "paymentMethod": "AE",
        "orderAmount": "100.00",
        "settleRate": "1",
        "orderCurrency": "USD",
        "txnAmount": "100.00",
        "txnCurrency": "USD",
        "customsDeclarationAmount": null,
        "customsDeclarationCurrency": null,
        "arn": null,
        "appId": "replace_with_app_id",
        "website": "https://merchant.example.com",
        "cardBinCountry": "US",
        "cardNumber": "370000******0002",
        "walletTypeName": null,
        "reason": null,
        "holderName": "Example Cardholder",
        "eci": null,
        "email": "customer@example.com",
        "creditCard": {
          "holderName": "Example Cardholder",
          "year": "2029",
          "month": "11",
          "verificationResult": null,
          "cardType": "AE",
          "productCategory": null,
          "issuer": "Example American Express Issuer",
          "cardNumber": "370000******0002"
        },
        "channelRequestId": "replace_with_channel_request_id",
        "lpmsUserId": null,
        "paymentMethodDetails": {
          "card": {
            "checks": {
              "addressCheck": "fail",
              "postalCodeCheck": "fail",
              "cardholderNameCheck": "fail",
              "avsResultRawCode": "W",
              "threeDSecureResult": null
            },
            "holderName": "Example Cardholder",
            "year": "2029",
            "month": "11",
            "cardType": "AE",
            "productCategory": null,
            "issuer": "Example American Express Issuer",
            "cardBinCountry": "US",
            "authorizationCode": "replace_with_authorization_code",
            "cardNumber": "370000******0002"
          }
        },
        "metaData": null
      }
    ],
    "current": "1",
    "size": 10,
    "totalPages": 1,
    "totalElements": 1
  }
}
No error responses are documented for this endpoint.

Query chargebacks

Query chargeback records by chargeback ID, transaction identifiers, or import time range.

Create payment link

Create a hosted payment link and return its Payment Link ID and checkout URL.