Request Method :: POST

Description: This API enables merchants to process customer payments securely using anetwork token in place of the primary card number.This approach enhances security by reducing exposure of sensitive card data,while ensuring seamless authorization and settlement of purchase transactions.

Headers

requestTimestamp : 123432553255

transactionid: 100170

merchantId:1234

orderId:100156

merchantId:1234
clientId:  To be shared during integration by ISU Team
hmacSecret::  To be shared during integration by ISU Team
Content-Type: application/json

Header Parameters

Parameters Max Length Data types Mandatory/Optional Parameter Description
requestTimestamp 13 String Mandatory Epoch timestamp in milliseconds
transactionid 20 String Mandatory Unique Transaction ID
merchantId 15 String Mandatory Merchant identifier
orderId 20 String Mandatory Order Reference ID
clientId 64 String Mandatory Client authentication key
hmacSecret 64 String Mandatory HMAC Signature key
Content-Type - String Mandatory Must be application/json

Request Body Parameters

Parameters Max Length Data types Mandatory/Optional/conditional Parameter Description with samples
apiOperation 10 String Mandatory Must be PURCHASE
authzTxnId 19 String Mandatory Authorization ID.E.g.-100180
isRecurring - Boolean Mandatory true/false
pTxnId 20 String Optional Parent Transaction ID.E.g.111110009323
isMoto - Boolean Mandatory Indicates if it was a Mail Order/Telephone Order or not
authentication - Object Conditional Authentication Details
  • authcTxnId
 19 String Conditional 3DS transaction ID.E.g.-1300
  • skip3ds
 - Boolean Conditional Bypass 3DS if true.E.g.-false
  • 3dsProvider
 - String Conditional 3DS provider name.E.g.Others
  • eci
 - String Mandatory Electronic Commerce indicator.E.g.-99
  • messageVersion
 - String Mandatory Message version.E.g.-2.2.0
  • threeDSServerTransID
 128 bit UUID number String Mandatory 3DS server transaction ID.e.g.550e8400-e29b-41d4a716-446655440000
  • dsTransID
 36 String Mandatory DS transaction ID.e.g.3151a145-6b31-4b6ebe6c-27c756c5d3e8
  • transStatus
 - String Mandatory Transaction status.e.g.-Y
  • cavv
 base64 Encoded String Mandatory Card holder authentication verification value.(inbase64)
sourceOfFunds - Object Mandatory Payment Source
networkTokenDetails - Object Mandatory Network token details
  • scheme
 - String Mandatory Type of payment card.e.g.VISA
  • tokenPAN
 16/td> String Mandatory Token PAN no.generated by card network.e.g.3456785593568727
  • tokenExpiryMonth
 2 String Mandatory Token expiry month.e.g.-02
  • tokenExpiryYear
 2 String Mandatory Token expiry year.e.g.-28
  • cryptogram
 - String Mandatory e.g.-Af9xkQZt9p3HAAABAg==
  • tokenRequestorId
 11 String Mandatory Token request or ID.e.g.12345678901
  • type
 - String Mandatory Network Token
order - Object Mandatory Transaction Details
  • currency
 3 String Mandatory Currency code.E.g.-AED
  • amount
 - String Mandatory Transaction amount.E.g.-100

Sample Request Body

Response Body Parameters

Parameters Data Type Parameter description
apiOperation String Confirms the operation type(purchase)
order Object Order details
  • id
 String order ID
  • amount
 String Transaction amount
  • currency
 String Currency(may differ from request)
payment Object Payment Status
  • id
 String Payment ID
  • entity
 String Payment Entity type
  • amount
 String Transaction Amount
  • currency
 String Currency(may differ from request)
  • status
 String SUCCESS or FAILED
  • method
 String Card
  • description
 String Description Message
  • international
 String YES if international card
  • refundStatus
 String Status of refund if applicable
  • amountRefunded
 String Total Amount Refunded
  • captured
 String YES(immediate settlement)
  • email
 String Customer Email
  • contact
 String Customer Contact
  • cardid
 String Card ID
  • wallet
 String Wallet
  • notes
 String Transaction Notes
  • created_date
 String Date of transaction creation
tokenDetails Object Token Details
  • cardToken
 String Card token issued by the card network
  • tokenExpiry
 YYMM Token expiry month year details.
  • cardSuffix
 String The last few digits(commonly last 4)of the original card number.
  • panUniqueReference
 String Unique identifier for PAN
  • tokenUniqueReference
 String Unique token reference
  • merchantTokenRequestorId
 String Token requestor ID from merchant
  • tokenType
 String token type
  • tavv
 String Token Authentication Verification Value
acquirerData Object Bank processing details
  • rrn
 String Retrieval Reference Number
  • authenticationReferenceNumber
 String 3DS auth reference(if applicable)
  • bankTransactionId
 String Bank’s transaction ID
  • stan
 String System trace audit number
  • merchantID
 String Merchant ID
  • terminalID
 String Terminal ID
  • brand
 String Merchant Brand name
  • merchantName
 String Name of the Merchant
isRefunded Boolean Indicates if transaction was refunded
isVoid Boolean Indicates if transaction was voided
isMoto Boolean Indicates if it was a Mail Order/Telephone Order
success Object Success
  • responseMsg
 String Response Message
  • responseCode
 String Response Code

Sample Response Body