refunded_wallet

The unspent balance of a wallet was returned.

Not revenue either; the amount is allowed in features by name.

Sent with	server, platform keys (see write keys)
Mode	strict: exactly the declared fields; an undeclared key, a wrong type or a missing required key quarantines the event
Version	1 (_schema_version on the stored row)
State	active
Required fields	none
Revenue	none: the revenue block is refused. Money-like names allowed in features: refund_amount
Identity evidence	none
Before consent	no

Fields

The activity's own fields, sent as features. Identifier and attribute fields are moved out of features by the processor; see identifiers and attributes.

Field	Type	Required	What happens to it	Meaning
currency	string	no, may be null	stays in features	ISO 4217 code of the amounts on the activity.
event_id	string	no, may be null	stays in features	The Eventix event the activity is about. Copied to the stream's _event_id column, so filters on an event are fast; it must be a plain string.
refund_amount	string	no, may be null	stays in features	The amount returned from the wallet, as a decimal string.
transaction_id	string	no, may be null	stays in features	The transaction in the cashless or payment system; makes a resend idempotent together with the activity id.

Example

One activity in a batch to POST /v1/activities, with debug so the answer says what the processor made of it. The envelope page explains every top-level field.

{
  "batch": [
    {
      "activity_id": "0192f1a4-988f-7ab2-8000-988fab210000",
      "activity": "refunded_wallet",
      "ts": "2026-10-17T20:00:00+02:00",
      "owner_ref": "own:own_01M4XX0033FV7QXDRB5BQBRPGR",
      "identifiers": [
        {
          "type": "chip",
          "value": "WB-0093",
          "role": "holder",
          "namespace": "payvent"
        }
      ],
      "features": {
        "currency": "EUR",
        "event_id": "3a114ef5-6105-48fd-aafc-0ae609d0536c",
        "refund_amount": "7.50",
        "transaction_id": "trx_01M4XVBYC3FGXCPFRZEPGV20RZ"
      }
    }
  ],
  "debug": true
}

Try it

Sends this request from your browser. The key and the endpoint are kept in this browser only.

ServiceWrite key

POST /v1/activities{ "batch": [ { "activity_id": "0192f1a4-988f-7ab2-8000-988fab210000", "activity": "refunded_wallet", "ts": "2026-10-17T20:00:00+02:00", "owner_ref": "own:own_01M4XX0033FV7QXDRB5BQBRPGR", "identifiers": [ { "type": "chip", "value": "WB-0093", "role": "holder", "namespace": "payvent" } ], "features": { "currency": "EUR", "event_id": "3a114ef5-6105-48fd-aafc-0ae609d0536c", "refund_amount": "7.50", "transaction_id": "trx_01M4XVBYC3FGXCPFRZEPGV20RZ" } } ], "debug": true }

Versions

Version	Mode	Key classes	Change
1 (current)	strict	server, platform	first version

A published version never changes; a change is a new version, and every stored row says which version it was checked against.