跳转到主要内容
WEBHOOK
virtualAccountCreateUpdate
{
  "version": "V1.6.0",
  "event_name": "VIRTUAL",
  "event_type": "virtual.account.create",
  "event_id": "831ec4d0-7dfa-4f6c-a565-ba8e1550de26",
  "source_id": "a3b4932d-8b6e-4cc4-bc0b-b1e9049135ee",
  "data": {
    "account_bank_id": "",
    "account_holder": "UQPAY PTE LTD",
    "account_id": "b1b89684-c2c4-4d54-b8a8-3572727fd120",
    "account_number": "",
    "bank_address": "",
    "bank_name": "",
    "capability": {
      "payment_method": ""
    },
    "clearing_system": {
      "type": "",
      "value": ""
    },
    "close_reason": "",
    "country_code": "",
    "currency": "GBP",
    "direct_id": "0",
    "request_id": "",
    "status": "Processing"
  }
}
Create Virtual Account 接口的同步响应仅是受理——无论虚拟账户是否真正开通成功，接口都会返回 SUCCESS。最终状态由本 Webhook 推送：
  • virtual.account.create：UQPAY 已受理对应币种的开户申请。
  • virtual.account.update 且 status = Active：VA 已开通成功，可以使用。
申请失败时不会推送任何 Webhook。 如果在预期时间内未收到 virtual.account.update，请联系 UQPAY support。

​
事件类型

事件类型描述
virtual.account.create新的虚拟账户已创建。
virtual.account.update已有虚拟账户被更新。
virtual.account.closed虚拟账户已关闭。

请求体

application/json
​
event_id
string<uuid>
必填

A unique identifier for this event.

​
event_name
enum<string>
必填

Top-level event category.

可用选项:
VIRTUAL
​
event_type
enum<string>
必填

The specific event type that occurred.

可用选项:
virtual.account.create,
virtual.account.update,
virtual.account.closed
​
source_id
string
必填

Account bank ID.

​
version
string
必填

API version number.

示例:

"V1.6.0"

​
data
object

Virtual account details associated with the event.

响应

200

Return 200 to acknowledge receipt.