一次集成，多条连接功能
在您的集成背后运行的路由
路由与级联在您已在使用的同一套 API 背后运行。您无需逐一对接本地连接——由我们完成。
路由
根据交易所属国家和支付方式，评估可用的本地连接。
级联
如果某个连接因技术原因失败或性能下降，交易可在备用连接上重试。
韧性
单一服务商的故障不必让您的支付停摆。
一次集成
连接由我们新增和维护，您无需重新集成。
规则共同制定
覆盖范围和路由规则根据您的国家、支付方式和业务流程与我们的团队商定。
状态透明
组件状态和事件历史在我们的状态页面公开。
工作流程
评估、路由、级联、报告
评估
根据国家、支付方式和规则，核对每笔交易的可用连接。
路由
将交易发送至最有把握完成的连接。
级联
若该连接失败或性能下降，在已配置备用连接时转至备用连接。
报告
无论交易走哪条路径，每笔交易都只有一条记录和一个状态。
范围
智能路由覆盖什么，需要您做什么
收款方式
- 包含内容
- 各国可用的银行转账、二维码、电子钱包和银行卡
- 说明
- 入驻时按市场逐一确认
国家
- 包含内容
- 14 个具备本地清算通道的国家中的任意一个
- 说明
- 仅在同一市场存在多条连接时提供备用路由
触发条件
- 包含内容
- 技术故障和连接性能下降
- 说明
- 业务拒绝（余额不足、信息错误）不会重试
规则
- 包含内容
- 由我们的团队按国家、方式和流程与您共同配置
- 说明
- 随交易量和市场变化定期复核
限额与价格
- 包含内容
- 无额外限额，适用所支付方式的限额
- 说明
- 请联系销售
您的集成
- 包含内容
- 相同的端点、状态、Webhook 和报表
- 说明
- 您这边无需任何改动
覆盖范围取决于各市场可用的连接。我们的团队会针对您的国家和支付方式逐一确认。
为什么重要
单一连接 vs. 路由与级联
单一连接
- 单点故障服务商一出故障，您的支付随之中断。
- 技术失败即失败一次超时或连接降级就意味着丢失一笔支付。
- 每接一家都是一个项目增加冗余意味着又一次集成、又一份合同和又一套报表。
- 数据分散每家服务商都用自己的格式出报表。
Localpayment 路由与级联
- 备用连接在拥有多条连接的市场，备用连接随时待命。
- 技术失败另有路径交易可以级联至另一条连接，而不是直接失败。
- 通过配置新增新连接由我们配置，无需重新集成。
- 一套 API，一份报表所有路径使用相同的状态、webhook 和报表。
覆盖范围
与我们的团队一起，为您的市场量身配置
路由与级联取决于各国家、各支付方式可用的连接。接入期间，我们的团队会为您梳理适合业务流程的路径和备用规则，并随着市场和业务量的变化持续复核。
- 按国家和支付方式梳理
- 备用规则与您的团队商定
- 随新增市场和业务量持续复核
概览
USD
1,284,560.00
+4.2%
BRL
3,420,118.40
+12.8%
MXN
8,905,332.10
+6.1%
- 收款 · Pixorder_8F2K-1043+ R$ 1,250.00
- 付款 · SPEIseller_0921− MX$ 18,400.00
- 换汇 · BRL → USDfx_3b7q250,000.00 USD
- 收款 · Bre-Border_9A1C-2210+ COP 890,000
- 09:41:02.11409:41:02PayIn100 INPROGRESS20084 ms
- 09:41:05.90209:41:05PayIn200 COMPLETED20091 ms
- 09:42:18.33009:42:18PayOut100 INPROGRESS20077 ms
- 09:42:40.01809:42:40PayOut200 COMPLETED20088 ms
- 09:43:00.55109:43:00VirtualAccount200 COMPLETED20080 ms
POST https://example-merchant.com/webhooks/localpayment
x-Signature: HMAC-SHA256 3f9a1c0e…b47e2b
{ "transactionType": "PayIn", "transactionFlow": "DIRECT",
"data": { "externalId": "order_8F2K-1043",
"status": { "code": "200", "description": "COMPLETED" } } }面向您的团队
为负责支付表现的团队而设计
产品与增长
级联为技术失败的支付提供另一条路径，无需改动收银台。
财务
无论哪条连接处理了支付，都是同一套结算流程和同一份报表。
工程
无需为每条连接额外集成：相同的接口、状态和 webhook。
开发者
无需路由字段：请求保持不变
路由在 Create Payin 端点背后完成。您只需发送与以往相同的请求；路径选择和级联由我们处理，每笔交易您只会收到一个状态和一个 Webhook。
- 所有国家使用同一请求格式
- 无论走哪条路径，始终是一个 externalId、一个状态、一个 Webhook
- Stage 环境与生产一致，不涉及真实资金
# 在哥伦比亚创建一笔 PSE 收款（示例数据均为虚构），路由无需额外字段
curl -X POST https://api.stage.localpayment.com/api/payin/ \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"paymentMethod": { "type": "BankTransfer", "code": "1936", "flow": "REDIRECT" },
"externalId": "9d2b4c10-0000-4000-8000-000000000042",
"country": "COL",
"currency": "COP",
"amount": 185000,
"accountNumber": "<your-account-number>",
"conceptCode": "0003",
"merchant": { "type": "COMPANY", "name": "Tienda Ejemplo S.A.S." },
"payer": {
"type": "INDIVIDUAL",
"name": "Camila",
"lastname": "Rojas",
"email": "camila@example.com",
"document": { "type": "CC", "id": "00000000" }
}
}'常见问题
路由需要单独集成吗？
不需要。路由与级联在您用于支付的同一套 Localpayment API 背后运行。
覆盖哪些国家和支付方式？
取决于各市场可用的连接。我们的团队会在接入期间确认您所需国家和支付方式的覆盖情况。
可以自定义路由规则吗？
路由和备用规则根据您的国家、支付方式和业务流程，与我们的团队共同配置。
你们会公布授权率提升数据吗？
不会。效果取决于您的国家、支付方式和客户组合，因此我们会与您一起复盘表现，而不是给出一个笼统的数字。
路由会改变我的报表或 webhook 吗？
不会。无论交易走哪条路径，您都保留相同的状态、webhook 和报表。
如何获知故障信息？
公开状态页面展示实时组件状态和事件历史。我们的支持团队 7×24 小时在线：support@localpayment.com。