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