Loading

How NPSP Gift Entry Handles Payments and Opportunities.

Publish Date: May 13, 2026
Description

In Nonprofit Success Pack (NPSP), an Opportunity represents a donor’s commitment to give, while a Payment represents the actual receipt of funds.  Opportunities and Payments are tightly linked as two parts of the same donation lifecycle.
For standard one-time donations, NPSP automatically creates a single Payment record associated with the Opportunity if "Automatic Payment Creation" setting is checked in NPSP Settings and Do_Not_Automatically_Create_Payment__c on Opportunity record is set to FALSE.

Users may notice the following behaviors using GIFT ENTRY:

  1. Selecting Update Payment and clicking Save & Process marks the Payment as Paid even when no payment fields were modified because updating a Payment through Gift Entry indicates that the donation has been received.
  2. Updates the related Opportunity status to Closed Won
  3. The Update Opportunity option appears disabled (greyed out) when the Opportunity contains exactly one unpaid Payment.

These behaviors are standard NPSP functionality intended to maintain data consistency between Opportunities and Payments.

Resolution

Why "Update Payment" Marks the Payment as Paid

When a user selects Update Payment in Gift Entry, NPSP interprets the action as confirmation that the donation payment has been received. As part of the gift processing workflow:

  • The Payment status is automatically updated to Paid even when any of the payment fields are not updated.
  • The related Opportunity is automatically updated to Closed Won.

Recommended Approach

If users need to modify Payment details of Opportunity that has exactly ONE UNPAID PAYMENT without marking the Payment as Paid, they should:

  • Edit the Payment record directly outside of Gift Entry

Avoid using Gift Entry for administrative-only updates to unpaid Payments

Why "Update Opportunity" Is Disabled

When an Opportunity has exactly one unpaid Payment, NPSP disables the Update Opportunity option in Gift Entry because allowing direct Opportunity updates could cause the Opportunity and Payment records to become inconsistent.

This behavior prevents Opportunities and Payments from becoming unsynchronized. For example, updating the Opportunity independently could leave the associated Payment in an unpaid state.

Available Options

If updates are required for an Opportunity with a single unpaid Payment, users should edit the Opportunity record directly outside of Gift Entry.

Knowledge Article Number

005321984

 
Loading
Salesforce Help | Article