Receive Webhooks for Online Payments in Lighthouse Business Manager

Description: Learn how to receive Webhooks in Lighthouse Business Manager.

---

Receiving Webhooks

Shift4’s webhooks sends information to your application via HTTPS notifications as a JSON payload. 

To receive the webhook information you need to set up your application to be able to receive the data Shift4 is sending. Here are some steps to guide you. 

1. Select which webhook events you wish to receive. 
2. Create an HTTPS webhook endpoint (URL) on your local server.
3. Receive and parse each event object and ensure a returned response status code is sent. 
4. Test your endpoint. 
5. Make your endpoint publicly available at the HTTPS URL. 

Important: There may be occasions when the same webhook event is sent multiple times.
E.g. Resending of a batch or webhook testing.
Please ensure your application is configured to receive duplicate webhook events. 

The table below shows which unique fields identify a duplication per webhook event type.  

Event Type	Field
Sale	networkReferenceNumber
Refund	networkReferenceNumber
Dispute	recordid