Notify Transaction

By using Notify Transaction API, the Client can submit the transaction status of a previously requested transaction. Upon successful payment of the transaction, this notify transaction must be called then only Tutelar consider that transaction has been closed.

Notify Transaction.

POST https://secctrl.tutelar.io/api/v1/fraud-detector/transaction/notify

Post parameters description is given below,

Parameter	Type	Is Mandatory	Description
status	String	Yes	To complete a transaction like SUCCESS or FAILURE. For success transaction send value “success” or others “failure”.
orderId	Alphanumeric	Yes	Transaction order id
referenceNo	Alphanumeric	Yes	Transaction reference number
transactionId	Alphanumeric	Yes	Transaction ID

Sample Post Parameters

{
    "orderId": "ORD_10726",
    "referenceNo": "TXNREFxxxxxxxNqQ",
    "status": "success",
    "transactionId": "trans_61761"
}

Post Response

200

If status updates

{
    "success": true,
    "message": "Transaction status updated successfully",
    "data": {
        "orderId": "ORD_10726",
        "referenceNo": "TXNREFxxxxxxxNqQ",
        "requestedDateTime": "2023-09-11T11:35:01.403Z",
        "responseDateTime": "2023-09-11T11:35:01.498Z",
        "processedTime": 95
    }
}

422

if transaction not found

{
    "success": false,
    "code": 422,
    "message": "Transaction not found or status already updated",
    "data": {
        "orderId": "ORD_10726",
        "referenceNo": "TXNREFxxxxxxxNqQ",
        "requestedDateTime": "2023-09-11T12:09:48.357Z",
        "responseDateTime": "2023-09-11T12:09:48.404Z",
        "processedTime": 47
    }
}

If status is Invalid

{
    "success": false,
    "code": 422,
    "message": "Invalid Status"
}