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

Deposit Webhook

POST
/receive/webhook/uqpay/deposit
Receive UQPay deposit/inbound events. Triggered when a user receives funds via virtual account (BSB/account number) or PayID.
Event types:
deposit.pending: Deposit pending - new transaction record created (PENDING)
deposit.completed: Deposit successful - status updated to SUCCESS, user balance increased
deposit.compliance.rejected: Deposit rejected - status updated to FAILED
data fields:
deposit_id: Unique deposit id (UUID)
account_id: UQPay sub-account id (used to locate the customer)
deposit_status: Deposit status (Pending / Completed / Rejected)
deposit_currency: Deposit currency
deposit_amount: Deposit amount
deposit_fee: Provider fee
short_reference_id: Short reference id
sender_name: Sender name
sender_account_number: Sender account number
reference: Remittance reference / memo
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/deposit' \
--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
Virtual Account Webhook
Next
Payout Status Webhook
Built with