跳转到主要内容
PUT
启用或禁用虚拟帐户
此接口可让您临时启用或禁用虚拟账户。使用它可以暂停特定账户接收新资金(禁用),或重新激活该账户使其能够再次接收付款(启用)。这在合规审查期间管理客户账户、暂停订阅或其他运营控制时非常有用。

授权

Authorization
string
header
必填

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

请求头

Authorization
string
必填

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

路径参数

status
enum<string>
必填

enable 或 disable。

可用选项:
enable,
disable
示例:

"enable"

externalId
string
必填

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

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

"53025bf4-4c87-4b4f-8fea-b47004440f37"

响应

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[]

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

最后修改于 2026年11月10日