Update Fraud

Provide details of a payment that resulted in fraud

Methods

POST

Provide details of a payment that resulted in fraud

Request

Copied!
{
 "type": "object",
 "required": [
  "transactionReference",
  "merchant",
  "riskProfile",
  "source",
  "sourceDate",
  "acquirerReference",
  "fraudReasonCode",
  "value"
 ],
 "properties": {
  "transactionReference": {
   "type": "string",
   "minLength": 1,
   "maxLength": 64,
   "pattern": "^[-A-Za-z0-9_!@#$%()*=.:;?\\[\\]{}~`/+]*$"
  },
  "merchant": {
   "type": "object",
   "required": [
    "entity"
   ],
   "properties": {
    "entity": {
     "type": "string",
     "minLength": 1,
     "maxLength": 64,
     "pattern": "^[A-Za-z0-9 ]*$"
    }
   }
  },
  "riskProfile": {
   "type": "string",
   "minLength": 39,
   "maxLength": 2048,
   "format": "uri"
  },
  "source": {
   "type": "string",
   "enum": [
    "SAFE",
    "TC40"
   ]
  },
  "sourceDate": {
   "type": "string",
   "maxLength": 20,
   "format": "date-time"
  },
  "acquirerReference": {
   "type": "string",
   "minLength": 1,
   "maxLength": 128
  },
  "fraudReasonCode": {
   "type": "string",
   "minLength": 1,
   "maxLength": 16
  },
  "value": {
   "type": "object",
   "properties": {
    "amount": {
     "type": "integer",
     "minimum": 0,
     "maximum": 999999999
    },
    "currency": {
     "type": "string",
     "minLength": 3,
     "maxLength": 3,
     "pattern": "^[A-Z]{3}$"
    }
   },
   "required": [
    "amount",
    "currency"
   ]
  }
 }
}

Responses

Examples

POST
 Provide details of a payment that resulted in fraud
View

Link relationship

post
 Provide details of a payment that resulted in fraud 
POSThttps://try.access.worldpay.com/fraudsight/update/fraud
Copied!
{
  "Authorization": "Basic dXNlcjE6cGFzc3dvcmQ=",
  "Content-Type": "application/vnd.worldpay.fraudsight-v1.hal+json"
}
Copied!
{
  "transactionReference": "unique-transactionReference",
  "merchant": {
    "entity": "default"
  },
  "riskProfile": "https://try.access.worldpay.com/riskprofile/ewogICJ2IiA6IDEsCiAgImsiIDogMSwKICAiZCIgOiAieWdmQjlEdkZPSGd5OFZGRktwK05pZDhnUW9VelVySmNrRDMzRFhvTXA0bEhPOTZJK0t6aUUyR1ZvTjFSazNtUEhGVFJ3d0NwT0dITThOVnluMDNyTGtwbUVSVExWM1RLbC9td2RoOVZzWFNpbG9zVktUUkRrNVMwRllSeU5hMXZOYjFYWW1TSGgyRTc4SGdWaGwzV2FnWHNjUVQwYlFMdmc1UXN5VUF5Mk9yckRGWlJabzRMVlZ2eXBsU1U3ZjVYMXdFdjBoV3FHVXhYV3dpTitRYWZmMXlGZ0laN2Nkb0pIMG5EanNCZmdDcDd5MjM4U0ZNR2I2SDBTVUx0eE9vY3JBODk0N1JUaGU2NGlPNURONDNKS3c9PSIKfQ",
  "source": "TC40",
  "sourceDate": "2020-12-27T00:00:00Z",
  "acquirerReference": "02691780344910023278387",
  "fraudReasonCode": "5",
  "value": {
    "currency": "GBP",
    "amount": 250
  }
}

204

Copied!
{
  "Content-Type": "application/vnd.worldpay.fraudsight-v1.hal+json"
}
Copied!
{}