Documentation
Financial Policies

Financial Policies

Managed Mode reference. You do not configure these policies. They are enforced automatically for applicable ActionKinds.

Trigger example (derived from the managed catalog)

Financial policies typically trigger when the request includes amount/velocity context and crosses a managed threshold. They may emit WARN (approval required) or BLOCK.
Example ActionKind where financial policies apply: money.refund
Common required context fields: amount_usd, authz_decision, case_id, destination_id, destination_verified, invoice_id, recent_actions_count, time_window_minutes, transaction_id
Example threshold shapes used by these policies: {"maxAmountUsd":200} | {"maxActionsPerHour":25,"maxActionsPerMinute":5}

Example decision

WARN responses include an approval_token. BLOCK responses do not.
json
{
  "status": "WARN",
  "decision_id": "dec_...",
  "approval_token": "appr_...",
  "reasons": [
    "Warn and require approval for high-value refunds/credits."
  ]
}
json
{
  "status": "BLOCK",
  "decision_id": "dec_...",
  "reasons": [
    "Block refunds/credits/payouts without verified evidence and authorization."
  ]
}

Resolution

Apply the remediation specified by the policy that fired, then re-validate.
SummarySeverityApplies toRequired contextApprovalRemediation
Block refunds/credits/payouts without verified evidence and authorization.BLOCKmoney.refund, money.credit, money.payout, billing.changeinvoice_id, transaction_id, case_id, authz_decisionRequire support ticket/case, validated transaction reference, and server-side authz before executing.
Warn and require approval for high-value refunds/credits.WARNmoney.refund, money.creditamount_usd, invoice_id, case_idWARN requires approvalApprove only with case evidence. Consider dual approval for unusually large amounts.
Block payouts to unverified or new destinations.BLOCKmoney.payout, money.movedestination_id, destination_verified, amount_usdVerify destination ownership and risk checks. Use allowlisted payout destinations per account.
Warn when financial actions exceed safe velocity thresholds.WARNmoney.refund, money.credit, money.payout, money.moverecent_actions_count, time_window_minutesWARN requires approvalInvestigate automation loop or abuse. Rate-limit and require manual review temporarily.
Legal & Responsibility Notice
Summary
Informational only
Provided for general guidance. Not legal, compliance, security, or professional advice.
You control implementation
You are responsible for policies, prompts, integrations, workflows, and regulatory requirements.
Liability limitation
To the maximum extent permitted by law, the company disclaims liability for losses arising from use of this documentation or implementations based on it.