跳转到主要内容
本指南概述了跟踪虚拟账户状态和管理账户生命周期的不同方法。 Localpayment 提供多种方法来监控和检索虚拟账户的当前状态,包括单个账户检查、批量处理状态和 Business Portal 可视化。

可用性

所有支持虚拟账户的国家/地区均可进行虚拟账户状态监控:

开始之前

请确保您已备好:
  • 有效的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 访问

  1. 登录您的 LocalpaymentBusiness Portal
  2. 导航至 PayIn > Virtual Accounts > Activity 部分
  3. 使用筛选条件进行搜索:
    • 国家/地区:选择特定国家/地区,或选择“全部”以包含所有可用国家/地区。
    • 状态:按当前状态筛选帐户,或选择“全部”查看任何状态的帐户。
    • 日期范围:指定虚拟账户的创建日期范围。这将根据创建日期而非活动日期筛选列表。
    • 虚拟账号:您可以直接通过虚拟账号 (VAN) 进行搜索,快速找到特定条目。

后续步骤

在监控虚拟账户状态后,您可能需要执行其他管理操作:

付款说明

请向付款方提供“获取虚拟账户状态”API响应中返回的正确受益人详细信息,以便顺利处理付款。请查看特定国家/地区的说明,以确保准确合规地执行付款。

启用/禁用虚拟账户

根据业务需求或客户请求暂时中止或重新激活虚拟账户。

删除虚拟账户

永久停用虚拟账户。此操作将阻止所有未来向该账户的付款,但会保留其完整的交易记录。此操作不可逆。适用于不再需要的账户;如需恢复使用,请创建新账户。
最后修改于 2026年11月10日