1. Webhooks
PIK
  • Start
    • Getting Started
  • Authentication
    • Authentication Token
      POST
  • Global Account
    • Contacts
      • Create Contact
      • List Contacts
      • Get Contact
      • Count Contacts
    • Virtual Accounts
      • Create Virtual Account
      • List Virtual Accounts
      • Get Virtual Account
    • Transactions
      • List Transactions
      • Get Transaction
    • Account Balance
      • List Account Balances
      • Get Balance by Currency
    • Payout
      • Create Payout
    • Webhooks
      • Unified Webhook Entry
        POST
      • Virtual Account Webhook
        POST
      • Deposit Webhook
        POST
      • Payout Status Webhook
        POST
  • Payment Links
    • Payment Links
      • Create Payment Link
      • Update Payment Link
      • Get Payment Link Detail
      • Get Payment Link List
    • Transactions
      • Get Transaction List
  • Webhook
    • Global Account
      • Deposit Webhook
      • Payout Webhook
      • Virtual Account Webhook
    • Payment Links
      • Overview
      • Order Collect Out Webhook
      • Customer Payment Webhook
      • Customer Refund Webhook
      • Master Recharge Webhook
      • Web3 Direct Payment Webhook
      • Withdraw Out Webhook
  1. Webhooks

Virtual Account Webhook

POST
/receive/webhook/uqpay/va
Receive UQPay virtual account create/update events. Creating a VA usually triggers two callbacks: first when creation starts, then when creation completes with full account details.
Status flow: Creating -> Processing -> Active
Event types:
virtual.account.create: VA creation in progress (status -> Processing)
virtual.account.update: VA creation completed (status -> Active), full account details returned
data fields:
request_id: Unique request id (used to match the local VA record)
direct_id: UQPay internal id
account_id: UQPay account id
account_bank_id: UQPay bank account id
account_holder: Account holder name (returned on update)
account_number: Receiving account number (returned on update)
bank_name: Bank name (returned on update)
currency: Currency (returned on update)
country_code: Country code (returned on update)
clearing_system: Clearing system info (returned on update, nested object)
capability: Account capability info (returned on update, nested object)
Note: This endpoint is called by UQPay servers and does not require JWT auth.

Request

Authorization
JWT Bearer
Add the parameter
Authorization
to Headers
Example:
Authorization: ********************
or
Body Params application/jsonRequired

Examples

Responses

🟢200
Webhook received successfully
This response does not have a body.
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/receive/webhook/uqpay/va' \
--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
Previous
Unified Webhook Entry
Next
Deposit Webhook
Built with