API Reference
Transaction Status API
Overview
The Transaction Status (Requery) API allows merchants to track the status of transactions processed via the NTT DATA Payment Services gateway. It supports server-to-server communication using the POST method, with encrypted requests and responses.
Data Flow
- Merchants send encrypted transaction details (MID, merchTxnID, amount, txnCurrency) to query the status.
- The API returns an encrypted response, which the merchant decrypts using the provided NDPS encryption logic.
- Encryption logic must be implemented at the merchant's end for both request and response handling.
Prerequisites
- API Keys and Credentials: Must be available prior to integration.
- MerchTxnID: Must be maintained from the transaction initiation.
- HTTPS: Must be enabled with TLS v1.2 or higher.
- Test Environment: A sandbox environment must be set up to verify webhook responses.
- Signature Generation: Use the sequence
[merchID + merchTxnID + amount + txnCurrency]for encryption.
Possible Reconciliation Statuses
- RS: Reconciled Settled
- RNS: Reconciled Not Settled
- NRNS: Not Reconciled Not Settled
- PNRNS: Payment Not Reconciled Not Settled
- PNRS: Payment Not Reconciled Settled
Query Transaction Status
Retrieves the status of a transaction using encrypted transaction details.
The response is encrypted and requires decryption using NDPS logic.
Request Attributes
Attribute
Description
payInstrument
object (2 fields)
Optional
Payment Instrument
Response Attributes
Attribute
Description
payInstrument
object (5 fields)
Optional
Payment Instrument