跳转到主要内容
DELETE
删除虚拟账户
永久停用虚拟账户。此操作将阻止该账户接收任何未来的付款,但其所有历史记录和交易数据将保留,以用于合规性和对账。 重要提示: 此操作不可逆。已删除的账户无法重新激活。如果您需要恢复为同一收款人收款,则必须创建一个新的虚拟账户。

授权

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

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

最后修改于 2026年11月10日