Merge pull request #1451 from hshih-lead/amount-validate-opt

feat: Added validation option to allow $0 entry amount

batch.go

@@ -1064,6 +1064,9 @@ func (batch *Batch) ValidAmountForCodes(entry *EntryDetail) error {
 		return fieldError("Amount", ErrBatchAmountNonZero, entry.Amount)
 	} else {
 		if entry.Amount == 0 {
+			if batch.validateOpts != nil && batch.validateOpts.AllowZeroEntryAmount {
+				return nil
+			}
 			return fieldError("Amount", ErrBatchAmountZero, entry.Amount)
 		}
 	}

batch_test.go

@@ -1121,6 +1121,23 @@ func TestBatch__ValidAmountForCodes(t *testing.T) {
 	})
 }
 
+func TestBatch_ValidAmountForCodes_AllowZeroEntryAmount(t *testing.T) {
+	b1 := mockBatchWEB(t)
+
+	// Standard EntryDetails should pass
+	require.NoError(t, b1.Create())
+
+	// Verify a zero amount fails
+	b1.Entries[0].Amount = 0
+	require.ErrorContains(t, b1.Create(), ErrBatchAmountZero.Error())
+
+	// Bypass zero amount check
+	b1.SetValidation(&ValidateOpts{
+		AllowZeroEntryAmount: true,
+	})
+	require.NoError(t, b1.Create())
+}
+
 func TestBatch_AllowInvalidAmounts(t *testing.T) {
 	bh := &BatchHeader{
 		OriginatorStatusCode:    1,

docs/custom-validation.md

@@ -92,6 +92,9 @@ UnequalAddendaCounts bool `json:"unequalAddendaCounts"`
 ```
 // AllowInvalidAmounts will skip verifying the Amount is valid for the TransactionCode and entry type.
 AllowInvalidAmounts bool `json:"allowInvalidAmounts"`
+
+// AllowZeroEntryAmount will skip enforcing the entry Amount to be non-zero.
+AllowZeroEntryAmount bool `json:"allowZeroEntryAmount"`
 ```
 
 ### File Header

file.go

@@ -712,6 +712,9 @@ type ValidateOpts struct {
 
 	// AllowInvalidAmounts will skip verifying the Amount is valid for the TransactionCode and entry type.
 	AllowInvalidAmounts bool `json:"allowInvalidAmounts"`
+
+	// AllowZeroEntryAmount will skip enforcing the entry Amount to be non-zero
+	AllowZeroEntryAmount bool `json:"allowZeroEntryAmount"`
 }
 
 // merge will combine two ValidateOpts structs and keep any non-zero field values.

server/validate.go

@@ -48,6 +48,7 @@ const (
 	unequalAddendaCounts             = "unequalAddendaCounts"
 	preserveSpaces                   = "preserveSpaces"
 	allowInvalidAmounts              = "allowInvalidAmounts"
+	allowZeroEntryAmount             = "allowZeroEntryAmount"
 )
 
 // readValidateOpts parses ValidateOpts from the URL query parameters and from the request body.
@@ -75,6 +76,7 @@ func readValidateOpts(request *http.Request) (io.Reader, *ach.ValidateOpts, erro
 		unequalAddendaCounts,
 		preserveSpaces,
 		allowInvalidAmounts,
+		allowZeroEntryAmount,
 	}
 
 	var buf bytes.Buffer
@@ -130,6 +132,8 @@ func readValidateOpts(request *http.Request) (io.Reader, *ach.ValidateOpts, erro
 			opts.PreserveSpaces = yes
 		case allowInvalidAmounts:
 			opts.AllowInvalidAmounts = yes
+		case allowZeroEntryAmount:
+			opts.AllowZeroEntryAmount = yes
 		}
 	}