Unified Webhook Entry

POST

/receive/webhook/uqpay

Unified UQPay webhook entry. Routes to the corresponding handler based on the event_name field in the request body.

Supported event_name values:

VIRTUAL -> Virtual account events (same as /va)

DEPOSIT -> Deposit events (same as /deposit)

PAYOUT -> Payout status events (same as /payout)

BENEFICIARY -> Beneficiary events

ONBOARDING -> Sub-account onboarding events

Note: This endpoint is called by UQPay servers and does not require JWT auth. For Open API integrations, the dedicated paths (/va, /deposit, /payout) are recommended.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Body Params application/jsonRequired

Examples

Responses

🟢200

Webhook received successfully

This response does not have a body.

Request Example

Shell

JavaScript

Java

Swift

curl --location '/receive/webhook/uqpay' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "version": "1.0",
    "event_name": "VIRTUAL",
    "event_type": "string",
    "event_id": "string",
    "source_id": "string",
    "data": {
        "property1": "string",
        "property2": "string"
    }
}'

Modified at 2026-05-27 09:47:15

Create Payout

Virtual Account Webhook