跳转到主要内容
GET
获取虚拟账户状态
此接口用于检索您之前使用创建虚拟账户接口创建的特定虚拟账户的状态和详细信息。您可以使用此接口检查账户是否处于活动状态并可以接收付款。

授权

Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求头

Authorization
string
必填

用于身份验证的 Bearer 访问令牌。该令牌可从获取访问令牌或刷新访问令牌endpoint 获取。

路径参数

externalId
string
必填

您要管理的虚拟帐户的唯一标识符。此标识符必须与您创建帐户时提供的 externalId 值完全一致。使用此标识符可以指定目标帐户,以便执行诸如检索帐户状态或删除帐户等操作。

Pattern: [a-zA-Z0-9\- ]+
示例:

"9c590364-b6b4-116b-cf09-d63e8681c8fc"

响应

OK

currency
enum<string>
可用选项:
ARS,
BRL,
CLP,
USD,
MXN,
PEN
externalId
string

虚拟账户的唯一标识符。这与您请求中提供的 externalId 相同,确认返回的数据与正确的账户相符。

internalId
string

Localpayment交易标识符。

accountNumber
string

Localpayment账号。

beneficiary
受益人 · object

接收存入此虚拟账户资金的个人或实体。受益人是资金的最终接收者,但不一定是虚拟账户本身的合法所有者或持有人。

示例:
status
状态 · object

操作状态。

errors
object[]

交易过程中发生的错误数组。如果交易成功,则此数组为空。

disabled
boolean

指定虚拟帐户是启用还是禁用。

最后修改于 2026年11月10日