Webhook event

`payment.screening_flagged`

The sender address screened as review or blocked, including a hit found later on a payment that was first released as clear or unchecked. The money is in the merchant's wallet either way.

Type: payment.screening_flagged
The object it carries: the payment object
Subscribe with: payment.screening_flagged, payment.* or *

Example payload

The body of the request your endpoint receives, shown here over several lines. On the wire it is compact JSON; check its signature over the bytes exactly as they arrive.

Example payload

{
  "id": "evt_2n5m676rgqaxbwxtfnzzzjnm",
  "object": "event",
  "livemode": true,
  "created": "2026-10-11T14:06:41.117Z",
  "type": "payment.screening_flagged",
  "api_version": "2026-10-11",
  "data": {
    "object": {
      "id": "pay_2pe50hae6w2jk4sp1rcq5pae",
      "object": "payment",
      "livemode": true,
      "created": "2026-10-11T14:06:41.117Z",
      "order": "ord_0zymngngvf12b8b2cra7tb8e",
      "instruction": "pin_h73hkjr8dyp4zymaet5e2gbv",
      "status": "settled",
      "rail": "relay",
      "asset": "ethereum:usdc",
      "network": "ethereum",
      "amount": "22.410000",
      "value": {
        "amount": "22.41",
        "currency": "USD"
      },
      "transaction_hash": "0x709b55bd3da0f5a838125bd0ee20c5bfdd7caba173912d4281cae816b79a201b",
      "from_address": "0xdbF03B407c01E7cD3CBea99509d93f8DDDC8C6FB",
      "to_address": "0xfB6916095ca1df60bB79Ce92cE3Ea74c37c5d359",
      "confirmations": 14,
      "confirmations_required": 12,
      "unmatched": false,
      "unmatched_reason": null,
      "late": false,
      "ignored": false,
      "finalized": true,
      "screening": {
        "id": "scr_268aypc7xxt8g1bkbweajv0m",
        "status": "review",
        "checked_at": "2026-10-11T14:06:41.117Z"
      },
      "settlement": {
        "id": "stl_wrv1q8enp9g0fr2jqt1gwqrr",
        "asset": "base:usdc",
        "network": "base",
        "amount": "21.990000",
        "wallet": "wal_bsfw07hymawmda7gg8jsyy3g",
        "to_address": "0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed",
        "transaction_hash": "0x27ca64c092a959c7edc525ed45e845b1de6a7590d173fd2fad9133c8a779a1e3",
        "proved_by": "wallet_chain_read",
        "settled_at": "2026-10-11T14:09:55.764Z"
      },
      "seen_at": "2026-10-11T14:06:41.117Z",
      "confirmed_at": "2026-10-11T14:09:12.300Z",
      "settled_at": "2026-10-11T14:09:55.764Z",
      "reverted_at": null
    },
    "previous_attributes": {
      "screening": {
        "id": "scr_268aypc7xxt8g1bkbweajv0m",
        "status": "clear",
        "checked_at": "2026-10-11T14:06:41.117Z"
      }
    }
  },
  "request": {
    "id": null,
    "idempotency_key": null
  },
  "pending_webhooks": 1
}

Fields of data.object

Fields of data.object in payment.screening_flagged
Field	In this example
`id`	`"pay_2pe50hae6w2jk4sp1rcq5pae"`
`object`	`"payment"`
`livemode`	`true`
`created`	`"2026-10-11T14:06:41.117Z"`
`order`	`"ord_0zymngngvf12b8b2cra7tb8e"`
`instruction`	`"pin_h73hkjr8dyp4zymaet5e2gbv"`
`status`	`"settled"`
`rail`	`"relay"`
`asset`	`"ethereum:usdc"`
`network`	`"ethereum"`
`amount`	`"22.410000"`
`value`	An object with `amount`, `currency`
`transaction_hash`	`"0x709b55bd3da0f5a838125bd0ee20c5bfdd7caba173912d4281cae816b79a201b"`
`from_address`	`"0xdbF03B407c01E7cD3CBea99509d93f8DDDC8C6FB"`
`to_address`	`"0xfB6916095ca1df60bB79Ce92cE3Ea74c37c5d359"`
`confirmations`	`14`
`confirmations_required`	`12`
`unmatched`	`false`
`unmatched_reason`	`null`
`late`	`false`
`ignored`	`false`
`finalized`	`true`
`screening`	An object with `id`, `status`, `checked_at`
`settlement`	An object with `id`, `asset`, `network`, `amount`, `wallet`, `to_address`, `transaction_hash`, `proved_by`, `settled_at`
`seen_at`	`"2026-10-11T14:06:41.117Z"`
`confirmed_at`	`"2026-10-11T14:09:12.300Z"`
`settled_at`	`"2026-10-11T14:09:55.764Z"`
`reverted_at`	`null`

What each field means is on the page of the payment object. data.previous_attributes holds the old values of exactly the fields that changed: here screening.

Endpoints behind it

Calls that change payments. An event is also sent when a payer, the network, a timer or a person in the dashboard causes the change; the sentence above says which.