Webhooks

Setup Webhooks

Using webhooks allows us to communicate with your system in real time whenever one of your clients pays with borderless™ or whenever you complete an API Request.

A webhook is a notification sent from borderless™ when an event is triggered without the need to submit a request. borderless™ will send an HTTP POST request containing the data that is created to your webhook listener URL.

To get started setting up webhooks, please refer to the Webhooks Guide

Customer Subscribed Webhook

When a customer accepts their invitation to the plan and you have webhooks enabled for your account, we will notify you via webhook instead of email.

The webhook received will be similar to the payment notification webhooks in that the information will come encoded in a JWT in the body of the POST request sent to your endpoint. This JWT will be signed with your secret. It is your responsibility to verify that the JWT is correctly signed with your secret before accepting the data received is on behalf of borderless™. Your webhook secret can be found at the Developer Dashboard after enabling webhooks.

An example decoded JWT payload is below: