Request Method :: POST

Description: This API facilitate merchants to securely process scheduled or repeated payments for services such as subscriptions,memberships,or installments.

Headers

requestTimestamp : 123432553255

transactionid: 100170

merchantId:1234

orderId:100156
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 for initial transaction.E.g.88596592212899114
isRecurring - Boolean Mandatory true/false
pTxnId 20 String Mandatory Previous Transaction ID.E.g.-88596592229991114
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
sourceOfFunds - Object Mandatory Payment Source
provided - Object Mandatory Card details
card - Object Mandatory Card Details
  • number
 16 String Mandatory Card number.E.g.3456785593568727
expiry 2 Object Mandatory Expiry month(MM)& year(YY).
  • month
 2 String Mandatory Expiry month(MM)E.g.-02
  • year
 2 String Mandatory Expiry year(YY)E.g.-28
nameOnCard - String Mandatory Name on the card. E.g.santosh
securityCode 3-4 String Mandatory Card CVV.E.g.-123
coftConsent - Boolean Conditional Tokenization consent. E.g.false
type - String Mandatory Type of source(e.g.,card)
order - Object Mandatory Transaction Details
  • currency
 3 String Mandatory Currency code.E.g.-AED
  • amount
 - String Mandatory Transaction amount.E.g.-100
recurring - Object Mandatory Recurring payment details
  • recurType
 - String Mandatory "CIT"(Customer-Initiated) or "MIT"(Merchant-Initiated).

Sample Request Body

Response Body Parameters

Parameters Data Type Parameter description
apiOperation String Confirms the operation("recurring")
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
cardDetails Object Masked Card Info
  • id
 String Card entity id
  • entity
 String Payment entity type
  • name
 String Card Holder Name
  • last4
 String Last 4 digits(e.g.,8727)
  • network
 String Card network
  • type
 String Card type
  • issuer
 String Card issuer
  • emi
 String EMI details if applicable
  • subType
 String Sub type of card
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