跳转到主要内容
POST
此接口允许您模拟向虚拟账户支付款项。仅在 Stage 环境中可用。它旨在帮助商家测试其集成的端到端流程,包括接收付款通知和验证交易状态,而无需实际进行银行转账。
环境限制 此接口仅在 Stage 环境中可用,且仅用于测试目的。

付款人身份

使用创建虚拟账户时提供的相同受益人数据,包括姓名、文件类型和文件 ID。无需单独的测试身份;该接口会将付款人数据与账户创建期间登记的信息进行比对验证。

授权

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 格式。

paymentMethod
object
必填
country
enum<string>
必填

虚拟账户所在的国家/地区(ISO 3166-1 alpha-3)。

可用选项:
ARG,
BRA,
COL,
MEX,
PER,
CHL
currency
enum<string>
必填

支付货币(ISO 4217)。

可用选项:
ARS,
BRL,
COP,
MXN,
PEN,
CLP
amount
number
必填

要模拟的支付金额。

accountNumber
string
必填

Localpayment 与商家关联的账号,每个账号都是唯一的。

beneficiary
object
必填

资金接收方的相关信息。

payer
object
必填

关于模拟付款人的信息。使用与创建虚拟账户时为受益人提供的相同数据——姓名、文件类型和文件 ID。

响应

创建完成 - 模拟已成功触发。

transactionType
string

交易类型(例如,PayIn)。

示例:

"PayIn"

externalId
string

唯一标识符(externalId )由商家提供,用于跟踪交易。

internalId
string<uuid>

唯一标识符(internalId ) 由 Localpayment 分配给该交易。

paymentMethod
object

模拟交易中使用的支付方式。

country
string

交易发生的国家。

currency
string

交易货币。

amount
number

交易金额。

accountNumber
string

商家的账号。

status
object

模拟交易的状态。

最后修改于 2026年11月10日