提供钱包的市场支持收款
为全球企业创造价值
- Pix · PSE
- 同一 API 上的本地收款
- Pix · SPEI
- 本地支付通道，实时，7×24 小时
- AR · CO · MX
- 提供银行卡的市场
- Webhook
- 每笔付款的实时状态
为什么选择 Localpayment
多收款、一次集成、少对账
国际信用卡只是其中一部分。在拉美，消费者习惯用银行转账和二维码付款，而且每个国家的做法都不一样。
支持用户已经在用的方式
一次集成即可接入 Pix、PSE、Bre-B、CVU、CLABE、二维码和银行卡，偏好转账或二维码的买家不再流失。
一次集成，覆盖所有市场
每个市场都有自己的通道、证件、限额和规则。使用 Localpayment，各国请求结构一致，新市场通过配置即可开通。
数秒内确认
银行卡为实时授权，Pix、SPEI、TEF、CCE 和 Bre-B 等实时通道全天候数秒内确认。
统一余额，统一报表
每笔收款都以您的结算币种（通常为美元）记入 Localpayment 账户，并在同一套报表中对账，无需手工核对多家服务商的款项。
统一余额，统一报表 —
联系我们的销售团队
告诉我们您的市场和交易量，我们将与您一起设计集成方案。
支付方式
已支持的本地支付方式，一个接口。
按市场偏好选择支付方式，各国的集成方式保持一致。
银行卡
- ar
- co
- mx
- pe
阿根廷、哥伦比亚、墨西哥和秘鲁均支持 Visa 和 Mastercard；阿根廷和哥伦比亚另支持 American Express 和 Diners Club。
银行卡 —虚拟账户
- ar
- br
- cl
- co
- cr
- mx
- pe
为每位客户、每张发票或每笔订单分配专属的 CVU、Pix 密钥、CLABE、CCI、IBAN、Bre-B 密钥或智利账号。
虚拟账户 —本地支付方式（APM）
- ar
- bo
- br
- cl
- co
- gt
- pe
巴西的 Pix、哥伦比亚的 PSE、阿根廷的 Debin 和二维码、智利的 ETPAY、玻利维亚和秘鲁的二维码，以及危地马拉的 QR Fri 和 Wallet Fri。
本地支付方式（APM） —订阅
- co
- mx
- pe
按计划定期扣款或按需扣款，重试策略可配置。
订阅 —
ar
co
mx
pe
br
cl
cr
bo
gt工作原理
四步完成：从请求到入账
- 01
发起请求
调用 POST /api/payin/，传入国家（ISO-3）、币种、金额、paymentMethod 和唯一的 externalId。
- 02
客户付款
客户根据支付方式获得二维码、密钥、参考号或跳转链接。银行卡实时授权；虚拟账户和本地支付方式异步确认。
- 03
Webhook 通知
经 HMAC-SHA256 签名的 Webhook 会返回结果、您的 externalId 和我们的 internalId。
- 04
余额入账
款项以您的结算币种（通常为美元）记入您的 Localpayment 账户。
覆盖范围
各国收款方式
阿根廷
- 虚拟账户
- CVU
- 银行卡
- 支持
- 本地支付方式
- 二维码 · Debin
玻利维亚
- 虚拟账户
- —
- 银行卡
- —
- 本地支付方式
- 二维码
巴西
- 虚拟账户
- 虚拟账户（Pix 或 TED）
- 银行卡
- —
- 本地支付方式
- Pix
智利
- 虚拟账户
- 银行账户（TEF）
- 银行卡
- —
- 本地支付方式
- ETPAY
哥伦比亚
- 虚拟账户
- Bre-B 密钥
- 银行卡
- 支持
- 本地支付方式
- PSE
哥斯达黎加
- 虚拟账户
- IBAN（SINPE）
- 银行卡
- —
- 本地支付方式
- —
危地马拉
- 虚拟账户
- —
- 银行卡
- —
- 本地支付方式
- QR Fri · Wallet Fri
墨西哥
- 虚拟账户
- CLABE
- 银行卡
- 支持
- 本地支付方式
- —
秘鲁
- 虚拟账户
- CCI
- 银行卡
- 支持
- 本地支付方式
- 二维码
来源：docs.localpayment.com 各国指南。具体可用性会在商户入驻时逐一确认。
全生命周期
管理支付的完整生命周期
支付之后的所有操作都在同一平台完成，可通过 API 或 Business Portal 处理。
- 支持银行卡、虚拟账户和 APM 支付退款
- 通过 API 上传证据，管理拒付
- 在付款人确认前取消待处理的 APM 支付
- 下载退款付款凭证
- 通过 Get Available Payment Methods 接口构建动态收银台
- 支付时即时换汇，并通过报价令牌锁定汇率
- 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" } } }开发者
一个接口，按国家提供特定字段。
先通过 POST /api/token/ 完成认证，再为任意国家调用同一个 Create Payin 接口，并填入该国要求的字段。以下 Pix 示例会返回二维码，并通过 Webhook 确认结果。
- Bearer 令牌：访问令牌有效期 5 分钟，刷新令牌 24 小时
- 每个请求都带上您的 externalId；重复请求返回 HTTP 409
- Stage 环境与生产环境一致，不涉及真实资金
# 1) 获取访问令牌（Stage）。请将凭证保存在密钥管理服务中。 curl -X POST https://api.stage.localpayment.com/api/token/ \ -H "Content-Type: application/json" \ -d '{ "username": "<api-user>", "password": "<from-your-secrets-manager>" }' # 2) 创建一笔 Pix 收款（示例数据均为虚构） 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": "1314", "flow": "DIRECT" }, "externalId": "7c1e2f7a-0000-4000-8000-000000000001", "country": "BRA", "currency": "USD", "amount": 100, "accountNumber": "<your-account-number>", "conceptCode": "0003", "merchant": { "type": "COMPANY", "name": "Loja Exemplo Ltda" }, "payer": { "type": "INDIVIDUAL", "name": "Maria", "lastname": "Silva", "document": { "type": "CPF", "id": "000.000.000-00" } } }'
// Node.js 18+ (built-in fetch) · Stage · fictitious values const BASE_URL = 'https://api.stage.localpayment.com'; // 1) 获取访问令牌（Stage）。请将凭证保存在密钥管理服务中。 const tokenRes = await fetch(`${BASE_URL}/api/token/`, { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ username: process.env.LP_API_USER, password: process.env.LP_API_PASSWORD, }), }); const { access } = await tokenRes.json(); // 2) 创建一笔 Pix 收款（示例数据均为虚构） const res = await fetch(`${BASE_URL}/api/payin/`, { method: 'POST', headers: { Authorization: `Bearer ${access}`, 'Content-Type': 'application/json' }, body: JSON.stringify({ paymentMethod: { type: 'BankTransfer', code: '1314', flow: 'DIRECT' }, externalId: crypto.randomUUID(), country: 'BRA', currency: 'USD', amount: 100, accountNumber: process.env.LP_ACCOUNT_NUMBER, conceptCode: '0003', merchant: { type: 'COMPANY', name: 'Loja Exemplo Ltda' }, payer: { type: 'INDIVIDUAL', name: 'Maria', lastname: 'Silva', document: { type: 'CPF', id: '000.000.000-00' }, }, }), }); const payin = await res.json(); // 向客户展示 payin.qr.code（Pix Copia e Cola）；最终状态通过 Webhook 送达。
{ "transactionType": "PayIn", "externalId": "7c1e2f7a-0000-4000-8000-000000000001", "internalId": "b4c1d2e3-0000-4000-8000-00000000abcd", "paymentMethod": { "type": "BankTransfer", "code": "1314", "flow": "DIRECT" }, "country": "BRA", "currency": "USD", "amount": 100, "payment": { "currency": "BRL", "fxQuote": 5.0, "amount": 500.00 }, "status": { "code": "100", "description": "INPROGRESS", "detail": "The payin is pending the confirmation" }, "qr": { "code": "<pix-emv-code>", "expirationDate": "2026-10-01T12:00:00-03:00" }, "errors": [] }
常见问题
我的结算币种是什么？
通常为美元。当地货币收款会以您的结算币种记入 Localpayment 账户。您也可以在当地市场交易时段内，将本币余额兑换为欧元、英镑等其他硬通货。
付款是实时确认的吗？
银行卡为实时授权。Pix、SPEI、COELSA、TEF、CCE 和 Bre-B 等实时通道全天候数秒内确认。其他方式为异步确认，所有最终状态都会通过 Webhook 通知。
如何知道一笔付款已完成？
您会收到一个在 X-Signature 请求头中带有 HMAC-SHA256 签名的 Webhook。status.code 为 200 表示 COMPLETED。也可以调用 GET /api/transactions/{externalId}/status 查询。
可以退款吗？
可以。银行卡、虚拟账户和 APM 支付均可通过 API 或 Business Portal 退款。
每个国家都需要单独集成吗？
不需要。各地的请求结构完全相同；新市场通过配置开通，无需重新集成。
如何开始测试？
合作开始时即可获得 Stage 凭证。Stage 与生产环境一致且不涉及真实资金，您可以在上线前测试每一个流程。
每个国家可以提供哪些支付方式？
阿根廷、哥伦比亚、墨西哥和秘鲁支持卡支付；虚拟账户和本地支付方式（APM）以各国文档为准。支付方式目录列出了每种方式的代码和到账速度，由客户团队按配置开通。
可以用美元收款吗？
部分市场可以，例如哥斯达黎加、秘鲁和墨西哥（通过 SPID）的美元虚拟账户。多数国家付款人以当地货币付款，款项按您的结算货币入账。