可用性
所有支持虚拟账户的国家/地区均可进行虚拟账户状态监控:开始之前
请确保您已备好:- 有效的API 凭证(访问令牌)。
- 您要查询的虚拟账户 ID 或批次参考编号。
虚拟账户状态参考
虚拟账户在其生命周期内可具有以下几种状态:状态码并非虚拟账户状态所独有。例如,当请求未通过验证时,创建虚拟账户endpoint 也会返回代码
300,其描述为 REJECTED。请始终将 status.code 与 status.description 结合起来阅读,而不要仅依赖代码。获取虚拟账户信息
申请虚拟账户后,您可以使用以下任一方法查看账户状态:查看个人虚拟账户状态
使用外部 ID 通过 API endpoint 检索特定虚拟帐户的当前状态和详细信息。
检查批量虚拟账户状态
监控批量操作中创建的虚拟账户的状态,包括创建进度和任何错误。
通过 Business Portal 查看虚拟账户状态
使用可视化业务门户界面对虚拟账户进行手动监控、筛选和批量操作。
方法一:查看个人虚拟账户状态
使用个人状态 endpoint 检索特定虚拟帐户的当前状态和详细信息。示例请求
向获取虚拟账户状态endpoint 发送GET 请求。以下是使用 curl 的示例:
curl
关键请求参数
该请求需要几个关键对象:成功响应
关键响应字段
方法二:检查批量虚拟账户状态
监控批量操作中创建的虚拟账户的状态,包括创建进度和任何错误。示例请求
向获取虚拟账户状态(批量)endpoint 发送GET 请求。以下是使用 curl 的示例:
curl
关键请求参数
该请求需要几个关键对象:成功响应
关键响应字段
方法三:通过 Business Portal 查看虚拟账户状态
如需手动监控和可视化分析,请使用 Localpayment Business Portal 查看虚拟账户状态。Business Portal 访问
- 登录您的 LocalpaymentBusiness Portal
- 导航至 PayIn > Virtual Accounts > Activity 部分
- 使用筛选条件进行搜索:
- 国家/地区:选择特定国家/地区,或选择“全部”以包含所有可用国家/地区。
- 状态:按当前状态筛选帐户,或选择“全部”查看任何状态的帐户。
- 日期范围:指定虚拟账户的创建日期范围。这将根据创建日期而非活动日期筛选列表。
- 虚拟账号:您可以直接通过虚拟账号 (VAN) 进行搜索,快速找到特定条目。

后续步骤
在监控虚拟账户状态后,您可能需要执行其他管理操作:付款说明
请向付款方提供“获取虚拟账户状态”API响应中返回的正确受益人详细信息,以便顺利处理付款。请查看特定国家/地区的说明,以确保准确合规地执行付款。
启用/禁用虚拟账户
根据业务需求或客户请求暂时中止或重新激活虚拟账户。
删除虚拟账户
永久停用虚拟账户。此操作将阻止所有未来向该账户的付款,但会保留其完整的交易记录。此操作不可逆。适用于不再需要的账户;如需恢复使用,请创建新账户。

