diff --git a/java/google/registry/model/billing/RegistrarCredit.java b/java/google/registry/model/billing/RegistrarCredit.java
index bbbed1c7e..e97704d7e 100644
--- a/java/google/registry/model/billing/RegistrarCredit.java
+++ b/java/google/registry/model/billing/RegistrarCredit.java
@@ -37,7 +37,13 @@ import google.registry.model.registry.Registry;
 import org.joda.money.CurrencyUnit;
 import org.joda.time.DateTime;
 
-/** A per-registrar billing credit, applied toward future charges for registrar activity. */
+/**
+ * A per-registrar billing credit, applied toward future charges for registrar activity.
+ *
+ * <p>NOTE: While credits are tracked within the model, there is no built-in support for actually
+ * incorporating these credits into the generated billing data, and the model support for credits
+ * should be considered quasi-deprecated (it may be removed without notice).
+ */
 @ReportedOn
 @Entity
 public final class RegistrarCredit extends ImmutableObject implements Buildable {
diff --git a/java/google/registry/model/billing/RegistrarCreditBalance.java b/java/google/registry/model/billing/RegistrarCreditBalance.java
index a7838f407..09f3a4c1c 100644
--- a/java/google/registry/model/billing/RegistrarCreditBalance.java
+++ b/java/google/registry/model/billing/RegistrarCreditBalance.java
@@ -49,6 +49,10 @@ import org.joda.time.DateTime;
  * <p>The active balance of a credit object before (at) any given point in time T can be found by
  * taking the balance object with the latest effective time that is before (before or at) T, and
  * breaking any ties by choosing the mostly recently written among those balances.
+ *
+ * <p>NOTE: While credits are tracked within the model, there is no built-in support for actually
+ * incorporating these credits into the generated billing data, and the model support for credits
+ * should be considered quasi-deprecated (it may be removed without notice).
  */
 @ReportedOn
 @Entity