diff --git a/docs/SETTLEMENT_DEDUCTIONS.md b/docs/SETTLEMENT_DEDUCTIONS.md
new file mode 100644
index 00000000..e1501bc4
--- /dev/null
+++ b/docs/SETTLEMENT_DEDUCTIONS.md
@@ -0,0 +1,3 @@
+# Settlement deduction batches
+
+`settlement.record_deductions` accepts a bounded batch and records all deductions in one authorized cross-contract call. Validation failure leaves every deduction unapplied.