跳转到主要内容
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" } }

Documentation Index

Fetch the complete documentation index at: https://developers-sandbox.uqpaytech.com/llms.txt

Use this file to discover all available pages before exploring further.

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.