# Extend the webhook framework The Salesforce Lightning—Digital River Connector App comes with a webhook framework that is capable of accepting and consuming any webhook that can be configured in the Digital River [Dashboard](https://docs.digitalriver.com/digital-river-api/administration/dashboard). For OOTB (out-of-the-box) webhook events, see [Set up webhooks](/salesforce-lightning/salesforce-lightning-b2b-commerce-app-1.2/integrate-the-salesforce-lightning-app/step-11-set-up-webhooks.md). You can always extend this framework to implement custom code that will fire upon receipt of a [Webhook](https://docs.digitalriver.com/digital-river-api/order-management/events-and-webhooks-1/webhooks) from Digital River. The event needs to be added to the previously-created webhook in the Digital River [Dashboard](https://docs.digitalriver.com/digital-river-api/administration/dashboard). ## Extending the webhook To implement the custom business logic for your organization, write the subscriber code that extends the default Webhook Framework Extension point class \*\*\*\* `digitalriverv3.DRB2B_WebhookHandler`. For example, suppose you want to implement custom business logic for the event `refund.pending` * In your organization, create an Apex class that extends the extension point class `digitalriverv3.DRB2B_WebhookHandler global with sharing class DRB2B_RefundPendingWebhook extends the digitalriverv3.DRB2B_WebhookHandler { }` * Inside the class definition, override the method `processWebhookEvent` of the extension point class `digitalriverv3.DRB2B_WebhookHandler`. This method will have the **Event Payload** as one of its Input parameters. ``` global class DRB2B_RefundPendingWebhook extends digitalriverv3.DRB2B_WebhookHandler { global override void processWebhookEvent(RestResponse response, String webhookEventPayload) { // Custom Implementation } } ``` * Inside your method override, add your custom business logic. Ensure the `RestResponse` status code is set to 200 as shown in the sample implementation for the `refund.pending` webhook event below. ### DRB2B\_RefundPendingWebhook ``` global class DRB2B_RefundPendingWebhook extends digitalriverv3.DRB2B_WebhookHandler { private static final digitalriverv3.DCM_Logger logger = digitalriverv3.DCM_Logger.getInstance('Webhook Event'); global override void processWebhookEvent(RestResponse response, String webhookEventPayload) { // Log the event to DCM Application log object logger.debug('Event: refund.pending; Refund Pending Webhook Event Payload: ' + webhookEventPayload); Messaging.SingleEmailMessage email = new Messaging.SingleEmailMessage(); email.setSubject('Process Webhook for event: refund.pending'); email.setToAddresses(new List { 'example@digitalriver.com'}); email.setHtmlBody(webhookEventPayload + '

'); Messaging.sendEmail(new Messaging.SingleEmailMessage[] { email }); response.statusCode = 200; } } ``` Save your class and resolve any compilation errors. ## Configuring the Apex class Your Apex class must be configured so that the Connector is aware and executes this Custom Webhook handler implementation whenever it receives the event `refund.pending` from Digital River. 1. Go to the Custom Metadata Type `digitalriverv3_DR_Webhook_Configuration_` `mdt` and click **Manage Records**.\ ![](/files/fdxJva3ubpwpzolFgA7p) 2. Create a new **Metadata Type Record** for the **DR Webhook Configuration**.\ ![](/files/2BXYEx6EHGgO161g9nJS) * **Label**: `Refund Pending Webhook Handler` * **DR Webhook Configuration Name**: `Refund_Pending_Webhook_Handler` * **Webhook Event Name**: `refund.pending` (This is the [event type](https://docs.digitalriver.com/digital-river-api/order-management/events-and-webhooks-1/events-1#event-types) of the webhook.) * **Webhook Handler Name**: `DRB2B_RefundPendingWebhook` (Custom Class Name) 3. Click **Save**. 4. Set up the webhook for the Event Type `refund.pending` in the [Dashboard](https://docs.digitalriver.com/digital-river-api/administration/dashboard). 5. Go to **Webhooks** and click the webhook endpoint that you [previously configured](/salesforce-lightning/salesforce-lightning-b2b-commerce-app-1.2/integrate-the-salesforce-lightning-app/step-11-set-up-webhooks.md) for your organization. The endpoint URL is: `https://<>/services/apexrest/digitalriverv3/webhooks`\ ![](/files/cyI7I6Y77TIeqW98nw7U) 6. Select the event `refund.pending` for the Webhook Endpoint selected in the previous step. ### DRB2B\_RefundCompleteWebhook The following example shows how to extend the webhook framework, this time for the `refund.complete event`. In this example, an email is sent with the event payload. ``` global class DRB2B_RefundCompleteWebhook extends digitalriverv3.DRB2B_WebhookHandler { private static final digitalriverv3.DCM_Logger logger = digitalriverv3.DCM_Logger.getInstance('Webhook Event'); global override void processWebhookEvent(RestResponse response, String webhookEventPayload) {// Log the event to Application log object logger.debug('Event: refund.complete; Refund Complete Webhook Event Payload: ' + webhookEventPayload); // Send Email Messaging.SingleEmailMessage email = new Messaging.SingleEmailMessage(); email.setSubject('Process Webhook for event: refund.complete'); email.setToAddresses(new List { 'example@digitalriver.com' }); email.setHtmlBody(webhookEventPayload + '

'); Messaging.sendEmail(new Messaging.SingleEmailMessage[] { email }); response.statusCode = 200; } } ``` {% hint style="info" %} Continue with the steps detailed in [Configuring the Apex class](#configuring-the-apex-class) to complete the configuration of the webhook extension. {% endhint %} --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.digitalriver.com/salesforce-lightning/salesforce-lightning-b2b-commerce-app-1.2/extend-the-salesforce-lightning-app/extend-the-webhook-framework.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.