The flag status is used to alert you to any suspicious transactions on your account. Not every flagged payment is fraudulent, but flags indicate that a payment is worth investigating.
The risk settings configured for your business control when a flagged payment is triggered. When a payment is flagged, you must either capture or void it manually. If you take no action, the payment expires automatically after seven days, and the funds return to the customer.
When using our API, a flagged payment is indicated in the response with "flagged": true. The field looks like this:
In the Hub's Payments screen, flagged payments are identified by an orange status message. Flagged payments will not be captured automatically — even with auto-capture enabled.