The recommended and most efficient way to receive payment status updates is by configuring the webhook. A webhook is an automated system that sends real-time updates to your platform whenever a payment’s state changes — for example, when it’s confirmed or expired.
You can set your callback_url when creating an invoice, and OxaPay will automatically deliver the payment status updates to that URL.
Webhook Quick Guide:
Create an HTTPS endpoint on your server to handle POST requests.
Set the
callback_url
in your API request to that endpoint.Validate the
HMAC
in the header using yourAPI_KEY
.Return
200 OK
with"ok"
in the response body.