payment amount
Payment Amount Field
The Payment Amount field specifies the total amount of money received in a payment transaction.
Overview
The payment amount represents the total monetary value of the payment. This amount can be allocated to one or multiple orders, depending on how the payment was received.
Field Details
Data Type
- Type: Decimal number
- Format: Up to 10 digits, 2 decimal places (e.g., 12345678.99)
- Required: Yes
Validation
- Must be greater than zero
- Cannot exceed total outstanding of selected orders (unless recording overpayment)
- Supports two decimal places for cents
Payment Allocation
Single Order Payment
When a payment applies to one order:
- Payment Amount = Order Amount (for full payment)
- Payment Amount < Order Amount (for partial payment)
Multiple Order Payment
When a payment applies to multiple orders:
Payment Amount = Sum of all order allocations
Example:
Payment Amount: $500
├── Order #1: $300 allocated
├── Order #2: $150 allocated
└── Order #3: $50 allocated
Total: $500
Scenarios
Full Payment
Payment amount equals the order total:
- Order: $100
- Payment: $100
- Order becomes fully paid
Partial Payment
Payment amount is less than the order total:
- Order: $100
- Payment: $50
- Order outstanding: $50
Overpayment
Payment amount exceeds the order total:
- Order: $100
- Payment: $120
- System records: $100 to order, $20 credit
- Credit can be applied to future orders
Multi-Order Payment
Single payment covers multiple orders:
- Order A: $75 outstanding
- Order B: $50 outstanding
- Single payment: $125
- Both orders become fully paid