一个接口：POST /api/payin/
- 支持收款的国家
- 9
- 支持虚拟账户的国家
- 7
- 支持银行卡的国家：阿根廷、哥伦比亚、墨西哥和秘鲁
- 4
- 每笔付款的实时状态
- Webhook
挑战
仅依赖跨境收款，会带来显著的资金漏损
国际信用卡只是其中一部分。在拉美，消费者习惯用银行转账和二维码付款，而且每个国家的做法都不一样。
没有本地合作伙伴时
- 只能收银行卡许多买家更愿意用转账或二维码，没有这些选项就会放弃付款。
- 每个国家都要单独集成每个市场都有自己的通道、证件、限额和规则。
- 手工对账手工核对多家服务商的款项，又慢又容易出错。
使用 Localpayment 时
- 支持用户已经在用的方式一次集成即可接入 Pix、PSE、Bre-B、CVU、CLABE、二维码和本地卡组织。
- 所有国家同一套数据结构各地字段一致：country、currency、amount、paymentMethod、externalId。
- 统一余额、报表和 Webhook 格式每笔收款都记入您的账户，并在同一套报表中对账。
支付方式
已支持的本地支付方式，一个接口。
按市场偏好选择支付方式。请求结构始终不变，只需更换支付方式代码、国家和币种。
银行卡
- ar
- co
- mx
- pe
阿根廷、哥伦比亚、墨西哥和秘鲁均支持 Visa 和 Mastercard；阿根廷另支持 American Express、Naranja 和 Cabal，哥伦比亚另支持 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资金流
从结账到您的余额
一次请求创建付款，本地通道确认，签名 webhook 通知您的平台。
- 1
客户您的平台:
选择本地支付方式
Pix、SPEI、PSE、Bre-B、银行卡或该国可用的任何方式。
- 2
您的平台Localpayment:
POST /api/payin/
金额、币种、国家和付款人信息，一次请求完成。
- 3
Localpayment客户:
付款指引
二维码、密钥、参考号或跳转，视支付方式而定。
- 4
客户本地通道/银行:
在银行 App 中付款
付款人使用自己的银行或钱包授权。
- 5
本地通道/银行Localpayment:
通道确认
实时通道数秒内确认，其他通道按各自截止时间处理。
- 6
Localpayment您的平台:
签名 webhook
您的系统放行订单，余额入账。
示意流程。确认时间和截止时间取决于支付方式和国家。
工作原理
四步完成：从请求到入账
- 01
发起请求
调用 POST /api/payin/，传入国家（ISO-3）、币种、金额、paymentMethod 和唯一的 externalId。
- 02
客户付款
银行卡实时授权；虚拟账户和本地支付方式异步确认。
- 03
Webhook 通知
经 HMAC-SHA256 签名的 Webhook 会返回结果、您的 externalId 和我们的 internalId。
- 04
余额入账
款项以您的结算币种（通常为美元）记入您的 Localpayment 账户。
全生命周期
管理支付的完整生命周期
支付之后的所有操作都在同一平台完成，可通过 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" }
}
}'覆盖范围
各国收款方式
阿根廷
- 虚拟账户
- CVU
- 银行卡
- 支持
- 本地支付方式
- 二维码 · Debin
玻利维亚
- 虚拟账户
- —
- 银行卡
- —
- 本地支付方式
- 二维码
巴西
- 虚拟账户
- 虚拟账户（Pix 或 TED）
- 银行卡
- —
- 本地支付方式
- Pix
智利
- 虚拟账户
- 银行账户（TEF）
- 银行卡
- —
- 本地支付方式
- ETPAY
哥伦比亚
- 虚拟账户
- Bre-B 密钥
- 银行卡
- 支持
- 本地支付方式
- PSE
哥斯达黎加
- 虚拟账户
- IBAN（SINPE）
- 银行卡
- —
- 本地支付方式
- —
危地马拉
- 虚拟账户
- —
- 银行卡
- —
- 本地支付方式
- QR Fri · Wallet Fri
墨西哥
- 虚拟账户
- CLABE
- 银行卡
- 支持
- 本地支付方式
- —
秘鲁
- 虚拟账户
- CCI
- 银行卡
- 支持
- 本地支付方式
- 二维码
来源：docs.localpayment.com 各国指南。具体可用性会在商户入驻时逐一确认。
常见问题
我的结算币种是什么？
通常为美元。当地货币收款会以您的结算币种记入 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）的美元虚拟账户。多数国家付款人以当地货币付款，款项按您的结算货币入账。