跳转到主要内容
POST
只需一次 API 调用,即可从您的 Localpayment 账户向任何收款人发起无缝付款。通过此接口,您可以提供必要的收款人信息、转账金额、来源账户和概念代码等信息,将资金转给客户、供应商或合作伙伴。您将立即收到付款创建的确认信息或详细的错误信息,以便进行故障排除,从而简化您的整个支付流程,并确保准确及时的转账。
想在执行交易前锁定汇率吗?使用货币兑换报价 API生成该货币对的汇率报价。响应中包含 exchangeRateToken,在您的付款请求中传入该令牌即可锁定该汇率。报价汇率在令牌的 expirationDate 之前有效并受到保证,可保护您和您的用户免受市场波动的影响。
关于 comment 字段 该数值会通过支付网络传递给收款机构。最终是否向收款人显示该数值,取决于收款机构及其交易详情的呈现方式。

授权

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
必填

系统生成的唯一标识符,用于跟踪交易(包含字母、数字和连字符)。我们建议使用 UUID4 以确保唯一性。

country
enum<string>
必填

您的最终用户所在国家/地区(即处理付款的国家/地区),采用 ISO 格式。

可用选项:
ARG,
BOL,
BRA,
CHL,
COL,
CRI,
DOM,
GTM,
HND,
MEX,
PAN,
PRY,
PER
currency
enum<string>
必填

请指定货币代码。您可以选择:(A) 所选国家/地区的当地货币,或 (B) 您账户的货币。选择 (A) 时,客户将以其当地货币付款。选择 (B) 时,款项将记入您的账户,Localpayment 将处理外汇兑换,以收取等值的当地货币金额。

可用选项:
ARS,
BOB,
BRL,
CLP,
COP,
CRC,
DOP,
GTQ,
HNL,
MXN,
USD,
PYD,
PEN
amount
number
必填

交易金额必须以小数形式表示,并使用点号分隔符,但智利比索 (CLP) 除外,智利比索不得有小数位。

accountNumber
string
必填

将从中扣除该金额的 Localpayment 账号。

conceptCode
enum<string>
必填
可用选项:
0001,
0002,
0003,
0004,
0005,
0006,
0007,
0008,
0009,
0010,
0011,
0012,
0013,
0014,
0015,
0016,
0017,
0018,
0019,
0020,
0021,
0022,
0023,
0024,
0025,
0026,
0027,
0028,
0029,
0030,
0031,
0032,
0033,
0034,
0035,
0036,
0037,
0038,
0039,
0040
paymentMethod
object
必填
sender
object
必填

发件人信息。

beneficiary
object
必填

受益人信息。

merchant
object
必填

商家信息。

comment
string

此自由文本字段用于填写其他支付信息。信息将通过支付网络传输至收款机构;最终收款人是否能看到此信息取决于银行。请参阅此页面上的国家/地区详细信息。

requireAuth
boolean

当该值设置为“True”时,授权器 endpoint 必须通过内部 ID 运行,才能将状态更新为“已接收”。

响应

创建

externalId
string

系统生成的唯一标识符,用于跟踪交易(包含字母、数字和连字符)。我们建议使用 UUID4 以确保唯一性。

internalId
string

Localpayment交易标识符。

paymentMethod
object
country
string
currency
enum<string>
可用选项:
ARS,
BOB,
BRL,
CLP,
COP,
CRC,
DOP,
USD,
GTQ,
MXN,
PYG,
PEN,
UYU
amount
integer

交易金额。

accountNumber
string

Localpayment账号。

clientCode
string

客户端代码。

clientName
string

客户名称。

status
状态 · object

操作状态。

beneficiary
object
merchant
object

商家信息。

sender
object

发件人信息。

comment
string

此自由文本字段用于填写其他支付信息。信息将通过支付网络传输至收款机构;最终收款人是否能看到此信息取决于银行。请参阅此页面上的国家/地区详细信息。

exchangeRateToken
null

汇率令牌。

date
object
errors
object[] | null

错误信息。

internalLoteID
string

内部批次标识符。

最后修改于 2026年11月10日