API Reference

Refund API

Overview

The Refund API enables merchants to initiate refunds for successful transactions using the HTTP POST method. Requests and responses are encrypted using HMACSHA512.

URLs

  • UAT: https://caller.atomtech.in/ots/payment/refund?merchId=9135&encData=59B80AF255F3D
  • Production: https://payment.atomtech.in/paynetz/refund?merchId=7&encData=3efsgdfdfhgdhgggfbg

Process Flow

  • Merchant initiates a refund request for a successful transaction.
  • Request and response are encrypted using HMACSHA512.
  • NDPS validates the request and processes the refund.
  • Response is returned with refund status details.

Signature Generation

  • Type: HMACSHA512
  • Sequence: [merchId + password + merchTxnId + total amount + txnCurrency + api]

Example:
Request: 317157Test@1236545e02c9d8355INRREFUNDINIT
Signature: a4df464724d1154cf2d33baf9b08cb6740637040e46d29034de472445b0df68af31de3c7089c0355bf0b5c887d568cd87b43a7b875ded9de8c9c946d4e57d40d

Hash Keys

MerchIdreqHashKeyrespHashKey
317157KEY123657234KEYRESP123657234

Encryption Keys

MerchIdencReqKeyencResKey
317157A4476C2062FFA58980DC8F79EB6A799E75AEF0FA1B94B3C10D4F5B268F757F11

Initiate Refund

Initiates a refund for a successful transaction. The request and response are encrypted using HMACSHA512.

Request Attributes

Attribute
Description
payInstrument
object (3 fields)
Optional
Payment Instrument

Response Attributes

Attribute
Description
payInstrument
object (2 fields)
Optional
Payment Instrument