Read recurring and pledge commitment amounts in the API

In the recurring-subscriptions response, distinguish these fields:

• total: the stored finite subscription commitment, serialized as a string; null for an indefinite subscription.
• installment_amount: the scheduled installment amount.
• total_paid: the subscription paid total.
• total_remaining: the remaining amount as exposed by the subscription.
• installments[].value: that individual installment's amount.
• max_charges: the finite maximum charge count; null for indefinite subscriptions.
• recurs_indefinitely: whether the subscription is indefinite.

Do not sum the commitment again for every installment or multiply a rounded installment to infer an exact pledge total. The current pledge calculation preserves the donor-entered pledge total when that metadata exists; older records can require reconciliation. Use the correct subscription response and associated record identifiers rather than interpreting an individual gift/installation value as the whole commitment.

The response fields do not provide a command to generate extra sandbox payments immediately. For accelerated integration test data, ask Support to confirm the approved sandbox procedure. Do not change production billing dates to create test data.

Negative incentive deductible amount in the Gifts API

The Gifts API incentive.tax_deductible_amount is contribution value minus the linked incentive fair-market value. This serialization has no zero floor, so it can return a negative number when FMV exceeds that value; no linked incentive returns null. Do not apply receipt-display rules to this API field or interpret -1 as a documented sentinel. Verify the exact API/report column, gift value, reward and FMV before correcting a specific record. A school-approved receipt/tax interpretation requires separate review.