Actions, validation and dispute

An action = an amount applied to a beneficiary's balance (positive in most cases). Two validation models to choose from: Trust or Confirmation required.

Create an action

"Quick" action from a pre-defined task

1. Dashboard → tap a beneficiary to open their card.
2. Tap the FAB ➕ Quick action.
3. Pick a task (laundry, dishes, homework done…). Amount and sign are pre-filled.
4. The action is created immediately.

"Custom" action with free amount

1. Beneficiary card → button Custom action.
2. Pick the unit (€, points, minutes…), amount (negative if you need to subtract), validation mode, and an optional reason.
3. Tap Save the action.

Validation mode

Each action has a validation mode. You can set a global default in Preferences → Default validation mode, and override per task.

🤝 Trust (default)

The action is validated immediately. The beneficiary's balance is updated instantly. The beneficiary (if they have a paired Connect device) can dispute it within 48 hours if they disagree. After this delay, the action is final.

✋ Confirmation required

The action stays pending. The beneficiary receives a notification on their Connect device and must accept or refuse. Auto-acceptance after 48 hours without a response.

Dispute an action (Connect)

1. On Connect, drawer ☰ → To validate.
2. Section Disputable → tap Dispute on the action.
3. Enter a reason (optional but recommended) and confirm.
4. The master receives the dispute and can either cancel the action or maintain it with a comment.

Cancel an action (master)

The master can cancel an action at any time from the history:

1. Drawer → History.
2. Tap the action.
3. Tap Cancel.

The action isn't deleted — it moves to Cancelled status. The history remains auditable.

Possible statuses

• Validated — the action counts in the balance.
• Pending — Confirmation required mode, not yet accepted.
• Disputed — the beneficiary has triggered a dispute.
• Refused — the beneficiary explicitly refused (Confirmation required mode).
• Cancelled — cancelled after the fact by the master.