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 Developers > Webhooks in the left column navigation
3. Click Add Endpoint
4. For Endpoint URL, enter the following, replacing {myaccountprefix} with the prefix of your Soapbox site:
   
   https://{myaccountprefix}.secure.nonprofitsoapbox.com/component/donations/transactionNotification
   
   If your Soapbox site uses a custom URL with a custom SSL certificate, you may enter the following, replacing {www.myorg.org} with your Soapbox site URL:
   
   https://{www.myorg.org}/component/donations/transactionNotification
   
   
5. For Description, enter any text you wish
6. For Version, leave it as the default
7. For Events to Send, select the following two events:
   1. customer.subscription.deleted
   2. invoice.payment_succeeded
8. Click Add Endpoint

After you have created the webhook, you can test it by clicking the Send Test Webhook button and then clicking the same button in the popup. This will confirm that Soapbox accepts the webhook notification from Stripe.

Once this webhook is in place, notification will be sent to Soapbox 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."