Webhooks

1. Go to Setup.
2. In the Quick Find box, enter “Sites and Domains.”
3. Click “Sites.”
4. Enter a value for your Force.com domain.
5. Click Check Availability.
6. Review and accept the Site terms of use.
7. Click Register My Force.com Domain.

1. Go to Setup.

2. In the Quick Find box, enter “Sites and Domains.”

3. Click “Sites.”

4. Click New.

   

5. Enter a Site Label, Site Name, and a Default Web Address. (We suggest using "webhook" or "stripe" for the Site Label and Site Name.)

6. Set Active = "TRUE" (checked).

7. For the Active Site Home Page field, click the Lookup icon and select "InMaintenance". (The page is not visible. It's just a placeholder because a value is required).

8. Click Save.

1. Go to Setup. 
2. in the Quick Find box, enter and click “Sites.” 
3. Click Edit next to your webhook site.
4. Change the Default Record Owner to a user of your choice.
5. Click Save.

In this section, you will gather the different components that will make up the URL before adding it to Stripe.

The URL will have the following format: https://SITE_DOMAIN_NAME/SITE_PATH/services/apexrest/bt_stripe/webhook/WEBHOOK_LABEL

• SITE_DOMAIN_NAME = The Salesforce Domain Name for the Site you set up

• SITE_PATH = The Path for the Site

• WEBHOOK_LABEL = The value in the Payment Gateway Webhook Label field

• “services/apexrest/bt_stripe/webhook” remains the same

1. Go to Setup.

2. In the Quick Find box, enter “Sites and Domains.”

3. Click “Sites.”

4. Locate the site you just created and click the URL.

5. Copy the URL.

6. Replace “SITE_DOMAIN_NAME/SITE_PATH” with the copied URL.

7. Leave “services/apexrest/bt_stripe/webhook” as is.

8. Open the related Payment Gateway record.

9. Copy the value in the Webhook Label field.

10. Replace “WEBHOOK_LABEL” with the copied value from the Webhook Label field.

11. To verify that the new URL works, open a new browser tab and paste the URL. You will see the following message.

1. Go to your Stripe dashboard. When you create a Webhook URL for your Stripe account in test mode, ensure the "Viewing test data" switch is enabled.

2. Click the Developers tab at the bottom-left side of the screen.

3. Click Webhooks.

4. Click + Add destination to add a destination.

   

5. Click Your account.

6. Click into the Account section.

7. Check the Select all Account events option.

   

8. Scroll down to and click into the Charge section.

9. Click the Select all Charge events option.

   

10. Click into the Checkout section.

11. Check the options that are relevant to your use case.

    

12. Scroll down to the Invoice section.

13. Check the Select all Invoice events option.

    

14. Scroll down to the Payment Method section.

15. Check the Select all Payment Method events option.

    

16. Scroll down to the Refund section.

17. Check the Select all Refund events option.

    

18. Click Continue.

19. Select “Webhook endpoint.”

    

20. Click Continue.

    

21. Enter a Destination name.

22. Enter the URL you created in the Endpoint URL field.

23. Click Create destination.

24. To test the new Webhook Event, create a new charge Transaction, capture it, and charge it. A new Webhook Event will be created for the Transaction.

In Stripe, click the Events tab to see the newly created charge. The new Stripe Event ID will match the Webhook Event Event ID.

In this section, you will gather the different components that will make up the URL before adding it to Authorize.net.

The URL will have the following format: https://SITE_DOMAIN_NAME/SITE_PATH/services/apexrest/bt_stripe/webhook/WEBHOOK_LABEL

• SITE_DOMAIN_NAME = The Salesforce Domain Name for the Site you set up

• SITE_PATH = The Path for the Site

• WEBHOOK_LABEL = The value in the Payment Gateway Webhook Label field

• “services/apexrest/bt_stripe/webhook” remains the same

1. Go to Setup.

2. In the Quick Find box, enter “Sites and Domains.”

3. Click “Sites.”

4. Locate the site you just created and click the URL.

5. Copy the URL.

6. Replace “SITE_DOMAIN_NAME/SITE_PATH” with the copied URL.

7. Leave “services/apexrest/bt_stripe/webhook” as is.

8. Open the related Payment Gateway record.

9. Copy the value in the Webhook Label field.

10. Replace “WEBHOOK_LABEL” with the copied value from the Webhook Label field.

11. To verify that the new URL works, open a new browser tab and paste the URL. You will see the following message.

1. Go to your connected Authorize.net account dashboard.

2. Click the Account tab.

3. Click Settings.

4. Click Webhooks.

   

5. Click Add endpoint.

   

6. Define a Name.

7. In the Endpoint URL field, enter the Salesforce webhook Site URL you created.

8. Set Status = "Active".

9. Under Select Events, check "All Events."

10. Click Save.

If you have multiple Authorize.net accounts connected to your Salesforce org and want to create a Webhook Endpoint for each in Authorize.net, you can use the same Salesforce Site. Change the WEBHOOK_LABEL part of the URL to the Webhook Label value on the Payment Gateway record you want to use.

A global method that allows customers to process certain Stripe Billing webhook types asynchronously instead of via the Blackthorn batch jobs was added. If the Process Async checkbox = “True”, the existing web processing batch jobs will skip those webhooks.

Blackthorn customers are responsible for adding the logic that 1) sets the records they want as Process Async and 2) calls the async method to process them. The following example code creates a before trigger to check the Process Async box and an after trigger to call the async method.

Before proceeding, two updates must be made to the Site Guest User/public user.

Step 1: To avoid permission errors, give the Blackthorn | Payments (Site Guest User) permission set Read access to the Product (Product2) object.

1. Click the Gear icon in the upper right-hand corner.
2. Click Setup.
3. In the Quick Find box, enter and click “Permission Sets.”
4. Create a new permission set.
   1. Click New.
   2. In the Label field, enter a descriptive name for the permission set, such as “Read Access to Product2.”
   3. Click Save.
5. Configure object permissions.
   1. Click “Object Settings” or “Object Permissions” in the Apps section.
   2. Find and click the Product (Product2) object. If you don’t see it, use the search function to locate it.
   3. Click Edit next to the Products heading.
   4. In the Object Permissions section, set Read to “Enabled” (checked). Do not enable Edit, Create, and Delete unless they are needed.
   5. Click Save.

Step 2: Assign the newly created permission set to the public user.

1. Navigate back to the site you created.
2. Click Public Access Settings.
3. Click the View Users or Assign Users button.
4. Click the link for the site guest user.
5. In the Permission Set Assignments section, click Edit Assignments.
6. Move the newly created permission set from the Available Permission Sets column to the Enabled Permission Sets column.
7. Click Save.

trigger customWebhookTrigger on Webhook_Event__c (before insert, after insert) {
    if (Trigger.isBefore) {
        for (bt_stripe__Webhook_Event__c webhook : Trigger.new) {
            if (webhook.bt_stripe__Type__c == 'invoice.created') {
                webhook.bt_stripe__Process_Async__c = true;
            }
        }
    }

    if (Trigger.isAfter) {
        List<Webhook_Event__c> webhooks = [SELECT Id, Name, Type__c, Process_Async__c, Processed__c, Payment_Gateway__c, Data__c FROM Webhook_Event__c WHERE Id IN :trigger.new];
        for (Webhook_Event__c webhook : webhooks) {
            if (webhook.bt_stripe__Process_Async__c && webhook.bt_stripe__Type__c == 'invoice.created') {
                // Call without sharing class here to process the webhook
            }
        }
    }
}

NOTE: Replace 'invoice.created' or add additional webhook types as needed.