Pix · PSE · Debin · ETPAY- 巴西和哥伦比亚的账户对账户支付
- Pix · PSE
- 支持二维码支付的国家：阿根廷、玻利维亚、危地马拉和秘鲁
- 4
- 阿根廷和智利的银行支付
- Debin · ETPAY
- 危地马拉的电子钱包支付
- Wallet Fri
br
co
ar
cl
bo
gt
pe工作原理
四个步骤，一个接口
- 01
创建收款
调用 POST /api/payin/ 并选择支付方式代码，例如 Pix 为 1314，PSE 为 1936。
- 02
展示二维码或重定向
展示二维码或付款说明；如使用 PSE，则将付款人引导至银行流程。
- 03
付款人确认
付款人在自己的网上银行或应用中确认，任何卡数据都不会经过您的收银台。
- 04
Webhook 通知状态
最终状态异步送达，并附有 HMAC-SHA256 签名。
目录
各国本地支付方式
目前已有文档的账户对账户和二维码方式，以及 Wallet Fri。
阿根廷
- 本地支付方式
- 二维码 · Debin
玻利维亚
- 本地支付方式
- 二维码
巴西
- 本地支付方式
- Pix
智利
- 本地支付方式
- ETPAY
哥伦比亚
- 本地支付方式
- PSE
危地马拉
- 本地支付方式
- QR Fri · Wallet Fri
秘鲁
- 本地支付方式
- 二维码
来源：docs.localpayment.com 各国指南。在哥伦比亚，Bre-B 通过虚拟账户（Bre-B 密钥）收款。具体可用性在商户入驻时逐一确认。
运营
天生异步，与其他业务一同对账
本地支付方式在付款人确认时才完成，而不是在您发出请求时。我们负责跟踪等待过程，并在完成后一次性通知您带签名的最终状态。
- Webhook 通过 X-Signature: HMAC-SHA256 签名
- 付款人确认前可取消待处理的支付
- 支持 APM 支付退款
- 与银行卡、虚拟账户使用同一种报表格式
- 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" } } }开发者
用同一个请求接入 PSE
只需更换国家、币种和 paymentMethod.code，请求的其余部分保持不变。PSE 采用重定向流程，响应中会包含付款人银行门户的 URL。
- Pix 1314 · PSE 1936 · 每种方式都按代码选择
- 通过 Get Available Payment Methods 构建动态收银台
- 通过 API 取消待处理支付或办理退款
# 示意请求：PSE（哥伦比亚），字段已简化，详见 docs.localpayment.com
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": "c2b8e6d4-0000-4000-8000-000000000019",
"country": "COL",
"currency": "COP",
"amount": 350000,
"accountNumber": "<your-account-number>",
"conceptCode": "0001",
"merchant": { "type": "COMPANY", "name": "Comercio Ejemplo S.A.S.", "merchantId": "<your-merchant-id>" },
"payer": {
"type": "INDIVIDUAL",
"name": "Camila",
"lastname": "Rojas",
"document": { "type": "CC", "id": "1000000000" },
"email": "camila.rojas@example.com"
}
}'常见问题
什么是 APM？
替代支付方式是本地银行原生通道，包括即时银行转账、二维码方案和账户对账户流程。付款人在自己的银行或钱包应用中完成付款，无需输入卡数据。
付款多快能确认？
Pix 全天候数秒内确认。APM 为异步处理：付款人在您的收银台之外确认付款，每个最终状态都通过 Webhook 送达。
可以取消或退还 APM 支付吗？
可以。付款人确认前可取消待处理的支付，已完成的 APM 支付可以退款。
Debin 请求的有效期多长？
阿根廷的 Debin 请求若付款人未确认，将在两天后失效。
每种支付方式都需要重新集成吗？
不需要。所有方式都使用同一个 Create Payin 接口，只需更换支付方式代码、国家和币种。
付款人如何完成 APM 付款？
根据支付方式不同，付款人会被跳转到自己的银行（PSE）、扫描二维码，或在银行应用或 Wallet Fri 中确认付款请求。结账体验页面逐屏展示了每种流程。
付款以什么币种进行？
以各国本地货币付款，例如 Pix 使用 BRL、PSE 使用 COP、ETPAY 使用 CLP，并以您的结算币种计入您的 Localpayment 账户。