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

post

/api/v1/fraud-detector/transaction/refund

Body

orderIdstringrequired

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

reasonstringrequired

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

statusstring · enumrequired

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

Options: requested, processed

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://secctrl.tutelar.io/api/v1/fraud-detector/transaction/refund' \
  --header 'Content-Type: application/json' \
  --data '{
    "orderId": "ORD_10726",
    "reason": "Product Defective",
    "status": "requested"
  }'

200

422

200

{
  "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
  }
}

Refund status updated successfully