虚拟账户创建 / 更新

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.

Show child attributes

响应

200

Return 200 to acknowledge receipt.

受益人创建充值状态

账户与虚拟账户

交易

事件类型

请求体

响应

​事件类型

请求体

响应

事件类型