Dealer Payment Details (Transaction Query)

• Endpoint: /vpws/transaction
• HTTP Method: GET
• Response Content-Type: application/json
• Authorization: Valid AccessToken required.
  (See: 2. Authentication – Obtaining AccessToken)

Description

This service returns all details of a payment transaction performed via VPWS.

Querying can be done with one of

• referenceCode
• transactionId
• clientReferenceNumber

Note: The transaction can only be viewed if it belongs to the relevant dealer. Transactions belonging to other dealers may return 404 or 403 errors.

Query Parameters

Parameter	Type	Required	Description
referenceCode	string	Yes*	System reference number (e.g.: NTH2P00000003086)

Example Request

Method: GET
Authorization: Bearer {AccessToken}
URL: https://pgw.netahsilatdemo.com/vpws/transaction?referenceCode=NTH2P00000003086

Response Structure

The service returns the Transaction object directly.

Top-Level Fields

Field	Type	Description
clientReferenceNumber	string/null	Dealer order reference
referenceNumber	string	System reference number
tenantId	string (GUID)	Main tenant of the transaction
tenantPosId	string (GUID)	POS used
commRate	number	Applied commission rate
currencyType	string	Currency
transactionDate	string (ISO 8601)	Transaction date
installment	int	Number of installments
lastAmount	number	Current gross amount
lastNetAmount	number	Net amount after commission
id	string (GUID)	transactionId
transactionStatusId	int	Transaction status

Status Codes (transactionStatusId)

Code	Description
1	Successful
2	Failed
3	Pending

Example cURL

curl --location 'https://pgw.netahsilatdemo.com/vpws/transaction?referenceCode=NTH2P00000003086' \
--header 'Authorization: Bearer {AccessToken}'

Notes & Best Practices

• Using transactionId for transaction verification is recommended when possible.

• In 3D transactions, the final status must be checked via this endpoint after OTP.

• Card number is returned masked; full PAN is never returned.

• After cancellation or refund, lastAmount returns as updated.

• The paidTenantId field indicates which dealer performed the transaction.

• A dealer can only query their own transactions.