# Salesforce

The PayBee + Salesforce integration allows you to connect all donor and donation data collected on PayBee to your Salesforce Nonprofit Success Pack (NPSP) or Nonprofit Cloud (coming soon) account.

In **Salesforce Nonprofit Success Pack (NPSP)**, **Contact Mapping** and **Opportunity Mapping** are key features that determine how data from your nonprofit’s donation or transactions reports on PayBee are translated into Salesforce records. They define how fields from incoming data on PayBee are matched to Salesforce fields on Contacts, Opportunities, and related objects. By integrating PayBee with Salesforce you can read and write your donor records and transaction data on Salesforce.

### Understanding Contact Mapping and Opportunity Mapping

**Contact Mapping** defines how donor or constituent information (like names, emails, and addresses) from PayBee is connected to Salesforce Contact records. When you import or sync data from PayBee, NPSP uses Contact Mapping to:

* Identify whether the person already exists in Salesforce.
* Decide how to create or update Contact records.

Similarly, **Opportunity Mapping** defines how donation or transaction information is connected to Salesforce Opportunity records. When a transaction is entered or imported, NPSP uses Opportunity Mapping to:

* Determine which Opportunity fields to populate.
* Connect the Opportunity to the correct Contact (via Primary Contact Role) and Account.

## Integrate PayBee With Salesforce

### Add a new integration

Go to Integrations > Salesforce and tap on the Create New Integration button. Select the Environment - choose between Production and Sandbox. Enter the name of your integration and a description. You will then be navigated to integration settings.

### Connect integration with Salesforce, map contacts and opportunities and activate

#### Step 1: Connect to Salesforce

Connect PayBee with your Salesforce account.  First, go to Salesforce and login. Then, allow PayBee to access to read and write into Salesforce. See an example of the access dialog below.

<figure><img src="https://2556307568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MVbQYaTpoeLV6eAXrTw%2Fuploads%2F7Z4Br1292gLi2GwTUPRv%2FScreenshot%202025-11-12%20at%209.38.44%E2%80%AFPM.png?alt=media&#x26;token=ad6c3c48-cbfb-404d-a1f2-48a15bd1c42b" alt=""><figcaption></figcaption></figure>

#### Step 2: Select Installation

Next, choose between the Non Profit Success Pack or Non Profit Cloud service to sync all donor and transaction data.

<figure><img src="https://2556307568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MVbQYaTpoeLV6eAXrTw%2Fuploads%2FEc3PuodTowPf3IBmxVke%2FScreenshot%202025-11-12%20at%209.39.06%E2%80%AFPM.png?alt=media&#x26;token=89173600-f3e5-4633-97e4-d21789c238d0" alt=""><figcaption></figcaption></figure>

#### Step 3: Contact Mapping Preferences

Set all contact mapping preferences. To map the data, choose between matching the donor data by email only or email and full name.

<figure><img src="https://2556307568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MVbQYaTpoeLV6eAXrTw%2Fuploads%2FTdpJ4e6gJnDFp6jkzNWO%2FScreenshot%202025-11-12%20at%209.39.35%E2%80%AFPM.png?alt=media&#x26;token=de2ed4d7-6141-4f89-b8a5-e1b79a468257" alt=""><figcaption></figcaption></figure>

#### Step 4: Map Contact Data

Now, map the the donor data from PayBee into the Salesforce data fields using the form displayed on the screen.

<figure><img src="https://2556307568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MVbQYaTpoeLV6eAXrTw%2Fuploads%2FcvbyL0zg0oH30U2ICr59%2FScreenshot%202025-11-12%20at%209.40.20%E2%80%AFPM.png?alt=media&#x26;token=9376e9e0-6856-49b2-a761-e47bf08f20c0" alt=""><figcaption></figcaption></figure>

#### Step 5: Opportunity Matching Preferences

Set all opportunity mapping or transaction mapping preferences. You can also choose to include cash and check transactions as well as zero transactions made on PayBee.

<figure><img src="https://2556307568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MVbQYaTpoeLV6eAXrTw%2Fuploads%2FOT2REDEWaKxsCZ0Exdsu%2FScreenshot%202025-11-12%20at%209.40.47%E2%80%AFPM.png?alt=media&#x26;token=a9977559-7eea-4030-b0cf-1315dad4928d" alt=""><figcaption></figcaption></figure>

#### Step 6: Map Opportunity Data

Now, map the the transaction data from PayBee into the Salesforce data fields using the form displayed on the screen.

<figure><img src="https://2556307568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MVbQYaTpoeLV6eAXrTw%2Fuploads%2FtIkE5jsGsdiOBlJATKpj%2FScreenshot%202025-11-12%20at%209.41.47%E2%80%AFPM.png?alt=media&#x26;token=4f3a0a2c-1deb-4b8f-8607-1f551f5bc6c3" alt=""><figcaption></figcaption></figure>

#### Step 7: Activate

Finally, activate the integration to export all the donor and transaction data from PayBee into Salesforce.

<figure><img src="https://2556307568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MVbQYaTpoeLV6eAXrTw%2Fuploads%2FNiuqj0AfFUAprybqj1W2%2FScreenshot%202025-11-12%20at%209.50.08%E2%80%AFPM.png?alt=media&#x26;token=09a34d24-b8b3-4742-be17-be928c899e58" alt=""><figcaption></figcaption></figure>

#### Step 8: Test Integration

To test your integration, tap on the Test Send button. This will create an entry in the list of Contacts and Opportunities reports as seen below.

<figure><img src="https://2556307568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MVbQYaTpoeLV6eAXrTw%2Fuploads%2FQrxdt9duC0fJxs79dLzB%2FScreenshot%202025-11-13%20at%2012.38.22%E2%80%AFAM.png?alt=media&#x26;token=9adbbe25-3940-43bd-b61e-619b944b7f43" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2556307568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MVbQYaTpoeLV6eAXrTw%2Fuploads%2FlEdMpCmF52Ws53cKt3PJ%2FScreenshot%202025-11-13%20at%2012.38.39%E2%80%AFAM.png?alt=media&#x26;token=f1748619-35b0-474a-8e65-bdbb6c8082e2" alt=""><figcaption></figcaption></figure>

Once your integration is activated you can view all successful and failed transactions under the **Transactions** tab of your selected integration as in the example seen below.

<figure><img src="https://2556307568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MVbQYaTpoeLV6eAXrTw%2Fuploads%2FixiYpW2YRSjfRlldi1wv%2FScreenshot%202025-11-13%20at%2012.36.24%E2%80%AFAM.png?alt=media&#x26;token=d2ca8846-6049-421f-8e0a-12a75fd446f5" alt=""><figcaption></figcaption></figure>

You can also continue to manage the Contact and Opportunity Mapping by tapping on the **Data Mapping** tab as seen in the example below.

<figure><img src="https://2556307568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MVbQYaTpoeLV6eAXrTw%2Fuploads%2FmrKFAO0hMmbp0lOSTLgy%2FScreenshot%202025-11-13%20at%2012.41.47%E2%80%AFAM.png?alt=media&#x26;token=232ea7be-b4f8-4f2e-a452-be3eb44139da" alt=""><figcaption></figcaption></figure>

Any changes to the name or description of your integration, contact matching preference, contact updating preference, and preferences to include zero dollar transactions and cash/check transactions can be made by going to the **Settings** tab.

<figure><img src="https://2556307568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MVbQYaTpoeLV6eAXrTw%2Fuploads%2FJaULrITpPtkN6ZnlpZeA%2FScreenshot%202025-11-13%20at%2012.41.59%E2%80%AFAM.png?alt=media&#x26;token=c7922630-c231-4e81-a3d7-956b3ca29b8c" alt=""><figcaption></figcaption></figure>