{"method":"POST","path":"https://api.revcent.com/v2/fraud_detections","summary":"Create A Fraud Detection","description":"Create a single fraud detection using an existing source ID. View markdown documentation at https://revcent.com/documentation/markdown/mcp/operation/OverviewFraudDetection.md for an in-depth overview of this operation.","operationId":"CreateFraudDetection","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"source_id":{"type":"string","description":"A fraud detection must have an originating RevCent API call, which RevCent will find when you provide a value for source_id. The value for the source_id property can be the ID for the originating API call, sale, transaction, PayPal transaction, check or offline payment.","minLength":20,"maxLength":20},"void_sale":{"type":"boolean","description":"You can choose to automatically void the sale, by setting to true, if source_id is a RevCent sale ID. Default is false. Note: This will fully refund all entities of the sale and cannot be undone."},"flag_similar_sale":{"type":"boolean","description":"You can choose to have RevCent add fraud alerts to similar sales. Default is false."},"arn":{"type":"string","description":"The acquirer reference number, if applicable."},"event_date":{"description":"The date when the fraud occurred in ISO8601 format.","type":"string","format":"date-time"},"fraud_detection_date":{"description":"The date when the fraud was detected in ISO8601 format.","type":"string","format":"date-time"},"case_number":{"type":"string","description":"The case number, if applicable."},"third_party_integration_id":{"type":"string","description":"A 20 character third party integration ID, if applicable.","minLength":20,"maxLength":20},"third_party_fraud_detection_id":{"type":"string","description":"The third party integration fraud detection ID, if being created by a third party fraud detection service."},"third_party_order_id":{"type":"string","description":"The third party integration order ID, if being created by a third party fraud detection service."},"metadata":{"items":{"additionalProperties":false,"properties":{"name":{"type":"string","description":"A name paired to the value for the metadata object. Limited to 100 characters in length.","minLength":1,"maxLength":100},"value":{"type":"string","description":"A value paired to the name for the metadata object. Limited to 255 characters in length.","minLength":1,"maxLength":255}},"type":"object","required":["name","value"]},"type":"array","description":"An array of metadata objects, each metadata object being a name and value pair."}},"type":"object","required":["source_id"]}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"description":"","properties":{"api_call_id":{"type":"string","description":"A 20 character API call ID.","minLength":20,"maxLength":20},"api_call_unix":{"description":"Unix timestamp of when the API call was initiated.","type":"integer","format":"unix-time"},"code":{"description":"API call response code.","type":"integer","format":"int32","enum":[1]},"fraud_detection_id":{"type":"string","description":"A 20 character fraud detection ID.","minLength":20,"maxLength":20},"result":{"type":"string"}},"type":"object","additionalProperties":false}}},"description":"Successful response."},"default":{"content":{"application/json":{"schema":{"description":"","properties":{"api_call_id":{"type":"string","description":"A 20 character API call ID.","minLength":20,"maxLength":20},"api_call_unix":{"description":"Unix timestamp of when the API call was initiated.","type":"integer","format":"unix-time"},"code":{"description":"This value indicates that there is an error. Will always be 0.","type":"integer","enum":[0]},"error_code":{"description":"The specific error code.","type":"string"},"message":{"description":"A human readable description of the error.","type":"string"},"result":{"description":"A description of the API call result.","type":"string"}},"title":"APIStandardErrors","type":"object","additionalProperties":false}}},"description":"Error response."}}}