Webhooks

In this guide, we will look at how to register and consume webhooks to integrate your app with Protocol. With webhooks, your app can know when something happens in Protocol, such as someone sending a message or adding a contact.

Integration Guide

Introduction

Webhooks provide an efficient way for your system to receive real-time notifications about payment-related events from our platform. This includes scenarios when an order is placed and when a refund occurs.

Handling Webhooks

Once your endpoint receives a webhook request, you should:

1. Validate the Request: Ensure the request is from a trusted source.
2. Parse the Data: Decode the JSON data and process it according to your business logic. For example, updating order status or recording transaction details.
3. Respond to the Request: Respond to the webhook request. Typically, a HTTP status code 200 indicates successful receipt.

IP Allowlisting

To enhance security and ensure that webhook requests are only received from legitimate sources, we recommend setting up IP allowlisting for your webhook endpoints. This ensures that only requests from Teachify’s trusted IP addresses are accepted.

Teachify’s Webhook IP Address

Please add the following IP address to your allowlist for incoming webhook requests:

43.207.76.33