跳转到主要内容
POST
此接口允许您创建多个虚拟账户来接收本地 ACH 银行转账。通过将这些账户分配给特定的商户或最终用户,您可以简化对账流程并改进交易跟踪。

授权

Authorization
string
header
必填

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

请求头

Authorization
string
必填

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

请求体

application/json
externalId
string
必填

您提供的唯一标识符,用于标记和跟踪系统中的虚拟帐户。此 ID 将是对该帐户进行所有后续操作(例如,检查状态、禁用、删除)的主要参考依据。为确保唯一性并防止冲突,我们强烈建议使用 UUID4 格式。

accountNumber
string
必填

Localpayment账号。

country
enum<string>
必填

国家。ISO 3166-1 alpha-3。

可用选项:
ARG,
BRA,
CHL,
COL,
MEX,
PER
beneficiary
受益人 · object
必填

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

示例:

响应

创建

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

虚拟账户的唯一标识符。它与您在创建请求中提供的 externalId 值相同,确认该账户已成功登记到我们的系统中。在后续与此账户相关的所有 API 调用中,请使用此确切的标识符。

internalId
string

Localpayment交易标识符。

accountNumber
string

Localpayment账号。

beneficiary
object

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

status
状态 · object

操作状态。

errors
object[]

其他错误信息。

最后修改于 2026年11月10日