Creating a webhook with Stripe to receive recurring payment notifications

If you are using the Donations app to accept recurring donations using Stripe as your payment gateway, you can have notification of the subsequent monthly transactions sent to Soapbox to be stored in the Donations > Transactions. If you have Salesforce integration enabled, this will also create a record in Salesforce for the subsequent transaction.

In order to enable this functionality, you'll need to create a webhook in Stripe that will instruct Stripe to update Soapbox whenever a subsequent monthly transaction is processed for an ongoing recurring donation. To do so:

1. Login to Stripe
2. Click the Developers link
3. Click the Webhooks tab

The next steps will depend on the specifics of your Stripe interface.

Option 1:
Workbench has not been enabled in Stripe. The heading Webhook endpoints is displayed above a table with a button labeled + Add endpoint appearing in the upper right of that table

1. Click + Add Endpoint button
2. On the Listen to Stripe events page, enter the following information
   1. For the Endpoint URL field, choose one of the following
      1. If using a Soapbox Engage standard domain, replace {myaccountprefix} (without the curly brackets) with the prefix of your Soapbox Engage account:
         

         https://{myaccountprefix}.secure.nonprofitsoapbox.com/component/donations/transactionNotification

      2. If using a Soapbox Engage custom domain, replace {engage.example.org} (without the curly brackets) with your Soapbox Engage account's domain:
         

         https://{engage.example.org}/component/donations/transactionNotification

   2. Description =  "Soapbox Engage endpoint"
   3. Listen to = "Events on your account"
   4. Version = (leave as defaulted)
   5. Select events to listen to
      1. customer.subscription.deleted
      2. invoice.payment_succeeded
3. Click Add events button

Option 2:
Workbench has been enabled in Stripe. No Webhook endpoints table is displayed and there is a button with the label + Add destination 

1. Click + Add destination 
2. On the next page with the title Start by selecting which events you want to listen to, keep the default selected as Your account
3. Keep the API version selected as Your current version (xxxxx)
4. For Events, select the following events to listen to:
   1. customer.subscription.deleted
   2. invoice.payment_succeeded
5. Click Continue
6. On the next page with the title Choose where you want to send events, keep the default selected as Webhook endpoint
7. Click Continue
8. On the next page with the title Configure destinations,leave the Destination Name as is
9. For the Endpoint URL field, enter one of the following
   1. If using a Soapbox Engage standard domain, replace {myaccountprefix} (without the curly brackets) with the prefix of your Soapbox Engage account:
      

      https://{myaccountprefix}.secure.nonprofitsoapbox.com/component/donations/transactionNotification

   2. If using a Soapbox Engage custom domain, replace {engage.example.org} (without the curly brackets) with your Soapbox Engage account's domain:
      

      https://{engage.example.org}/component/donations/transactionNotification

10. For Description =  "Soapbox Engage endpoint"
11. Click Create Destination

Once the webhook is in place, notification will be sent to Soapbox Engage whenever a subsequent payment is made on both existing and future recurring donations in Stripe. Records added to the Donations > Transactions view will have a Payment Occurrence of “Subsequent recurring."