What is the webhook callback and how do I set it up?

An OxaPay webhook callback is an HTTP POST request that OxaPay sends to your server to notify you of payment events (e.g. a payment being completed). To receive these callbacks, you need to set up a webhook endpoint – a URL on your server that OxaPay can post data to. Here’s how to set it up:

• Create an HTTPS endpoint: Set up a route on your server (e.g. /oxapay/webhook) that listens for incoming HTTP POST requests. This endpoint should accept JSON data (content-type application/json). Use HTTPS to ensure the data is transmitted securely.

• Provide the URL to OxaPay: Configure this endpoint URL as the callback_url in your dashboard or when creating an API request. This tells OxaPay where to send the webhook notifications.

• Enable access: Make sure your server is publicly reachable by us. For example, OxaPay won’t send callbacks to localhost or private networks. For local testing, use a tool like ngrok to expose a public URL. Also ensure any firewalls or security settings allow OxaPay’s requests through.

To ensure optimal processing of callbacks, it's also recommended to whitelist OxaPay's IP addresses on your end. You can get these IPs by reaching out to our support team.