Billing/Webhooks

Setup

Webhooks allow your backend to receive real-time notifications about payment activity on the Acta Billing platform. When users initiate, complete, or fail a payment through your Paylinks, subscriptions, or APIs, Acta sends event payloads to your configured webhook URL — enabling you to update your database, grant service access, or trigger other business logic.

To start receiving payment events, you’ll first need to set up your webhook endpoint and register it in the Acta Hub.

Create a Webhook Endpoint

Set up an endpoint on your server that listens for incoming POST requests. This is where Acta will send webhook payloads. Ensure the endpoint supports JSON and returns a 200 OK response.

Register Webhook in Actalink Hub

Set up an endpoint on your server that listens for incoming POST requests. This is where Acta will send webhook payloads. Ensure the endpoint supports JSON and returns a 200 OK response.

  • Visit https://hub.acta.link and log in.
  • Select Acta Billing from top bar.
  • From the left sidebar, go to Developers → Webhooks.
  • Click on Create Webhook.
  • Provide the following:
    • Webhook Name – A label for your reference.
    • Webhook URL – Your live server endpoint.
  • Click Save to register the webhook.

Copy the Webhook Secret

After saving, a secret token will be generated. Copy this secret — you’ll use it to verify webhook payloads in your backend logic.
Never expose your webhook secret publicly.