Notify Transaction

By utilizing the Notify Transaction API, the client can submit the transaction status of a previously requested transaction. Tutelar will only consider the transaction closed upon successful payment, which triggers the notify transaction process.

Notify transaction status

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

Body

application/json

orderId*string

A unique identifier for the order associated with the transaction. It helps in tracking and referencing the specific order within the system.

Example: "ORD_10726"

status*enum

Indicates the completion status of the transaction. For a successful transaction, send the value "success". For all other cases, send the value "failure".

Example: "success"

successfailure

transactionId*string

A unique identifier for the transaction within the system. It is used to track and reference the specific transaction details.

Example: "trans_61761"

Response

200400

Transaction status updated successfully

Body

application/json

successboolean

Example: true

messagestring

Example: "Transaction status updated successfully"

dataobject

Request

JavaScriptCurlPython

const response = await fetch('https://secctrl.tutelar.io/api/v1/fraud-detector/transaction/notify', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "orderId": "ORD_10726",
      "status": "success",
      "transactionId": "trans_61761"
    }),
});
const data = await response.json();

Response

200400

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