Refund Transaction

A refund transaction is the process where money is returned to a customer for a purchase they previously made. In the context of fraud detection, refund transactions can be flagged for investigation if they exhibit suspicious or unusual patterns, such as an unusually high frequency of refunds, refunds of large amounts, or discrepancies between the refund request and the original purchase details. These flags help identify potential fraudulent activity, ensuring the integrity and security of the transaction process.

Refund Transaction

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

Body

application/json

status*enum

It is used to request the status of a refund for a transaction. The value should be one of the following: 'requested': Indicates that the refund has been requested but not yet processed. 'processed': Indicates that the refund has been processed.

Example: "requested"

requestedprocessed

orderId*string

This key represents the Transaction Order ID. It is a unique identifier for the transaction associated with the order for which the refund is being requested.

Example: "ORD_10726"

reason*string

This key is used to provide the reason for the refund. It explains why the refund is being requested, such as due to a product issue, service dissatisfaction, or any other relevant reason.

Example: "Product Defective"

Response

200422

Refund status updated successfully

Body

application/json

successboolean

Example: true

messagestring

Example: "Refund status updated successfully"

dataobject

Request

JavaScriptCurlPython

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

Response

200422

{
  "success": true,
  "message": "Refund status updated successfully",
  "data": {
    "orderId": "ORD_10726",
    "requestedDateTime": "2024-04-17T11:54:00.466Z",
    "responseDateTime": "2024-04-17T11:54:00.474Z",
    "processedTime": 8
  }
}