How to map a donation’s payment method to the NPSP Payments object

If your organization uses the Nonprofit Success Pack (NPSP) with Salesforce, you may want to map the payment method used to make a donation in Fundraise Up to the Payment method field on the NPSP Payments object.

Since the Payment Method field on the Payments object is a selected from a predefined set of values, it is necessary to create a custom field on the Opportunity object that includes all of the possible payment method options in Fundraise Up.


Steps

Follow the steps below to map a donation’s payment method to the NPSP Payments object.

Part 1: Create a picklist value set

Before creating a custom field on the Opportunity object, you should first create a picklist value set in Salesforce. This way, you can reuse the list of payment methods in other areas of Salesforce.

  1. In Salesforce, navigate to: Setup > Objects and Fields (In the “Platform Tools” section) > Picklist Value Sets
  2. Select New
  3. Set the Label value to Payment method
  4. Set the Name value to Payment method
  5. Add the following values to the Values textarea input:
    1. Credit card
    2. Apple Pay
    3. Google Pay
    4. PayPal
    5. Venmo
    6. ACH
    7. Plaid
    8. Click to Pay
    9. BECS Direct Debit
    10. iDEAL
    11. Stock
    12. Crypto
  6. Optional: Select the Display values alphabetically, not in the order entered option
  7. Select Save

Part 2: Create the custom field

Now that you have created a picklist value set, you will create the custom payment methods field on the Opportunity object.

  1. In Salesforce, navigate to: Setup > Objects and Fields (In the “Platform Tools” section) > Object Manager > Opportunity > Fields & Relationships. Then, follow the steps below
  2. Select New
  3. Select Picklist as the data type
  4. Set the Field Label to Payment method
  5. For the Values property, select Use global picklist value set
  6. From the select menu, choose Payment method as the global picklist to use
  7. Set Field name to Payment method
  8. Set the Auto add to custom report type value to Add this field to existing custom report types that contain this entity
  9. Select Next
  10. Confirm the field-level security settings and then select Next
  11. Confirm the page layouts where the new custom field should be shown and then select Save

Part 3: Mapping the custom field to the NPSP Payments object

So far, you have created a custom picklist for payment method values and attached it to a new custom payment methods field on the Opportunity. You will now map the values from the payment methods field on the Opportunity object to the Payment Methods field on the NPSP Payments object.

  1. In Salesforce, launch the Nonprofit Success Pack
  2. Select NPSP Settings
  3. Select Donations
  4. Select Payment Mappings
  5. Select New Payment Field Mapping
  6. From the Opportunity Field selector, choose Payment method
  7. From the Payment Field selector, choose Payment Method
  8. Select Create Custom Mapping

Part 4: Create a payment method mapping rule in Fundraise Up

Now that you’ve configured fields and mappings in Salesforce, you will configure a mapping rule in Fundraise Up to set the payment method value for the Opportunity object field.

  1. In Fundraise Up, view the Salesforce integration settings.
  2. Select Mapping rules
  3. Select Add rule
  4. For the Fundraise Up mapping, select the donation entity
  5. Select the payment method field
  6. For the Salesforce mapping, select the opportunity entity
  7. Select the payment method field

Wrapping up

In Fundraise Up, you created a mapping rule that syncs the payment method used at checkout to a custom payment method field on the Opportunity object in Salesforce. That field uses a global picklist of all available payment methods in Fundraise Up.

To sync the payment method field from the Opportunity object to the custom NPSP Payments object, you used NPSP’s built-in payments mapping tool to connect the payment method field on the Opportunity object to the payment method field on the NPSP Payments object.

As payment methods are added to Fundraise Up, it is necessary to update the picklist values for the Payment methods custom field on the Opportunity object in Salesforce.

Still need help?

Need help with something not covered in Support Center? Connect with a support engineer for more assistance.
Email us