Payment Query

The Payment Query API retrieves transaction results in the payment-intent dimension, allowing merchants to reconcile multiple transactionId attempts under the same paymentId .

Field Relationship

• transactionId: Single transaction attempt ID (attempt dimension).
• status: Status of the current transactionId, still using TxnStatusEnum.
• paymentId: Payment intent primary key (one paymentId can map to multiple transactionId attempts).
• paymentStatus: Payment intent status, see PaymentStatusEnum.

paymentStatus = N Scenarios

paymentStatus = N means the payment intent is closed, including:

1. User created an order but did not pay before timeout.
2. User made multiple failed attempts and the intent was finally closed by timeout.

API Request Parameters

POST

Key Parameters

It is recommended to provide at least one of the following filters:

• paymentId
• merchantTxnIds
• transactionIds
• startTime + endTime

Parameter	Type	Length	Required	Signed	Description
merchantNo	String	20	Yes	Yes	Merchant number assigned by Onerway upon registration, obtained from the Onerway merchant dashboard.
merchantTxnIds	String	/	Conditional	Yes	Multiple merchant transaction IDs for batch queries, separated by commas.
transactionIds	String	/	Conditional	Yes	Multiple Onerway transaction IDs for batch queries, separated by commas.
paymentId	String	/	No	Yes	Payment intent ID. Business type is Long, transmitted as String in JSON.
txnTypes	String	/	No	Yes	Transaction type filter for payment queries. Comma-separated values are supported.
startTime	String	/	Conditional	Yes	Start time for the transaction query period filter.
endTime	String	/	Conditional	Yes	End time for the transaction query period filter.
current	String	/	Yes	Yes	Page number for payment queries.
size	String	/	No	Yes	Page size.
sign	String	/	Yes	No	Digital signature string for request verification and security. Please refer to Signature for signature generation method.

Pagination Rules

• current=0 and current=1 both represent the first page.
• Response current is always returned as 1-based page number (1 is the first page).
• size default is 10, max is 100.

Response

Name	Type	Description
respCode	String	Response code from Onerway
respMsg	String	Response message from Onerway
data	Object	Response data. Refer to object data

data

Name	Type	Description
content	List	Payment records list.
└paymentId	String	Payment intent ID. Business type is Long, transmitted as String in JSON.
└paymentStatus	String	Payment intent status. See PaymentStatusEnum .
└lastTransactionId	String	Latest transaction attempt ID under this payment intent. Business type is Long, transmitted as String in JSON.
└lastPaymentAttempt	Object	Latest attempt result summary. Contains failure reason and advice.
└merchantTxnId	String	Merchant transaction ID.
└merchantTxnOriginalId	String	Merchant master order ID.
└txnTime	String	Latest attempt transaction time. Format: yyyy-MM-dd HH:mm:ss.
└txnCompletionTime	String	Latest attempt completion time. Format: yyyy-MM-dd HH:mm:ss.
└productType	String	Product type. See ProductTypeEnum .
└subProductType	String	Sub-product type. See SubProductTypeEnum .
└cardType	String	Card network or card type.
└orderAmount	String	Order amount.
└orderCurrency	String	Order currency. See ISO 4217.
└txnAmount	String	Transaction amount.
└txnCurrency	String	Transaction currency. See ISO 4217.
└arn	String	Acquirer Reference Number.
└appId	String	Merchant application ID. Business type is Long, transmitted as String in JSON.
└website	String	Website of transaction origin.
└cardNumber	String	Masked card number (first 6 + last 4).
└holderName	String	Cardholder name.
└eci	String	Electronic Commerce Indicator.
└email	String	Customer email.
└channelRequestId	String	Channel request ID.
└paymentMethodDetails	Object	Payment method detail object. Includes card fields (holderName, year, month, cardType, productCategory, issuer, cardBinCountry, authorizationCode, cardNumber) and card.checks fields (addressCheck, postalCodeCheck, avsResultRawCode, threeDSecureResult). See PaymentMethodDetailsCard for structure.
current	String	Current page number in response (1-based).
size	String	Page size.
totalPages	String	Total pages.
totalElements	String	Total records.

API Example

Request

{
  "merchantNo": "10001",
  "current": "1",
  "size": "10",
  "paymentId": "2031991417907576832",
  "transactionIds": "",
  "startTime": "2026-01-01 00:00:00",
  "endTime": "2026-03-28 23:59:59",
  "sign": "your_sign_value"
}

Response

{
  "respCode": "20000",
  "respMsg": "Success",
  "data": {
    "content": [
      {
        "paymentId": "2031991417907576832",
        "paymentStatus": "O",
        "lastTransactionId": "2031991417966297088",
        "lastPaymentAttempt": {
          "reason": "Acquirer suspected fraud",
          "adviceMsg": "Acquirer suspected fraud"
        },
        "merchantTxnId": "1773299479000",
        "merchantTxnOriginalId": null,
        "txnTime": "2026-03-12 15:11:21",
        "txnCompletionTime": "2026-03-12 15:11:50",
        "productType": "CARD",
        "subProductType": "DIRECT",
        "cardType": "VISA",
        "orderAmount": "100.00",
        "orderCurrency": "USD",
        "txnAmount": "100.00",
        "txnCurrency": "USD",
        "arn": null,
        "appId": "1839538258499215360",
        "website": "demo.onerway.com",
        "cardNumber": "471110******0000",
        "holderName": "CL BRW2",
        "eci": "07",
        "email": "abel.wang@onerway.com",
        "channelRequestId": "7777772031991538036387841",
        "paymentMethodDetails": {
          "card": {
            "checks": {
              "addressCheck": "unchecked",
              "postalCodeCheck": "unchecked",
              "avsResultRawCode": "FD",
              "threeDSecureResult": {
                "version": "UNKNOWN",
                "authenticationFlow": null,
                "chargebackLiability": "UNKNOWN",
                "transStatus": null,
                "transStatusReason": null,
                "veresEnrolled": null,
                "eci": "07",
                "cvvResult": null,
                "avsFullResult": null,
                "cavvResult": null
              }
            },
            "holderName": "CL BRW2",
            "year": "2026",
            "month": "05",
            "cardType": "VISA",
            "productCategory": null,
            "issuer": null,
            "cardBinCountry": "US",
            "authorizationCode": null,
            "cardNumber": "471110******0000"
          }
        }
      }
    ],
    "current": "1",
    "size": 10,
    "totalPages": 1,
    "totalElements": 1
  }
}

Best Practices

1. Use paymentId as the primary business key for reconciliation.
2. If you adopt the payment-intent model, store both status and paymentStatus; otherwise you can continue handling status only.
3. Apply fixed time windows for paginated queries to avoid unbounded scans.

Related Links

• Refund Query
• Transaction Webhook
• Signature