阿根廷 · 哥伦比亚 · 墨西哥 · 秘鲁- Pix · SPEI
- 本地支付通道，实时，7×24 小时
- 4
- 卡品牌：Visa、Mastercard、Amex 和 Diners
- 3D Secure
- 哥伦比亚、墨西哥和秘鲁
- 分期付款
- 哥伦比亚、墨西哥和秘鲁
为什么选择 Localpayment
提升银行卡支付转化，同时降低风险
复购更快
在四个市场均可用令牌代替卡片数据，让回头客更快完成支付，订阅也可直接从已存卡扣款。
分期提升客单价
在哥伦比亚、墨西哥和秘鲁，客户可使用信用卡以当地货币分期付款。
减少欺诈交易
哥伦比亚、墨西哥和秘鲁的 3D Secure、BIN 白名单和拒付管理，帮助您在可疑交易演变为拒付之前将其拦截。
缩小 PCI 范围
Smart Fields、嵌入式 iframe 和 WebCheckout 在我们托管的字段中采集卡数据，原始卡数据不会进入您的服务器。
缩小 PCI 范围 —
联系我们的销售团队
告诉我们您的市场和交易量，我们将与您一起设计集成方案。
卡组织
消费者常用的国际卡组织
四个市场均支持 Visa 和 Mastercard；阿根廷和哥伦比亚另支持 American Express 和 Diners Club，涵盖信用卡和借记卡。
ar
co
mx
pe工作原理
一笔银行卡支付的流程
- 01
采集
客户在 Smart Fields 或托管收银台中输入卡信息，或直接使用已保存的令牌。
- 02
授权
调用 POST /api/payin/，paymentMethod.type 设为 CreditCard，并填入该国的卡品牌代码。
- 03
按需验证
如果发卡行要求 3D Secure，请将客户重定向到响应中的验证 URL。
- 04
确认
结果实时返回，并通过签名 Webhook 通知，可直接用于发货和对账。
逐个市场
各国可用功能
银行卡功能因市场而异。以下为目前文档所涵盖的内容。
阿根廷
- 一次性支付
- ✓
- 令牌化
- ✓
- 退款
- ✓
- 拒付
- ✓
- 3DS
- —
- 分期付款
- —
- 订阅
- —
哥伦比亚
- 一次性支付
- ✓
- 令牌化
- ✓
- 退款
- ✓
- 拒付
- ✓
- 3DS
- ✓
- 分期付款
- ✓
- 订阅
- ✓
墨西哥
- 一次性支付
- ✓
- 令牌化
- ✓
- 退款
- ✓
- 拒付
- ✓
- 3DS
- ✓
- 分期付款
- ✓
- 订阅
- ✓
秘鲁
- 一次性支付
- ✓
- 令牌化
- ✓
- 退款
- ✓
- 拒付
- ✓
- 3DS
- ✓
- 分期付款
- ✓
- 订阅
- ✓
来源：docs.localpayment.com。巴西不提供银行卡收单，请使用 Pix 和 Pix 密钥虚拟账户。
功能
银行卡受理所需的一切
多层管控，帮助您在可疑交易演变为拒付之前将其拦截。
3D Secure
在哥伦比亚、墨西哥和秘鲁验证持卡人身份。发卡行发起验证时，API 会返回验证 URL。
BIN 白名单
在 Business Portal 中按发卡行和卡类型设置预先批准的 BIN，仅受理这些卡段。
拒付管理
每笔拒付都会收到 Webhook 通知，并可在截止日期前通过 API 或 Business Portal 上传证据。
分期付款
先获取分期方案报价，由客户选择后扣款；适用于哥伦比亚、墨西哥和秘鲁以当地货币支付的信用卡（秘鲁仅限 PEN）。
预授权与请款
先授权、后请款；订单取消时可释放冻结金额。各市场的可用性在入驻时确认。
退款
通过 API 或 Business Portal 办理银行卡退款，并下载付款凭证。
PCI 范围
让原始卡数据远离您的服务器
通过 Smart Fields、嵌入式 iframe 或 WebCheckout 采集卡信息。卡数据在我们托管的输入框中录入，并转换为令牌，由您的后端随收款请求一并发送。
- Smart Fields：通过 JS SDK 在您自己的界面中嵌入托管卡字段
- 嵌入式 iframe：白标收银台，PCI 范围更小
- WebCheckout 与支付链接：无需编码，PCI 范围最小
- 传输中采用 TLS 1.2+，静态数据采用 AES-256，并通过 AWS KMS 轮换密钥
API 演示
用令牌收取卡款
在墨西哥用卡令牌调用 POST /api/payin/（Visa 代码 1600）。Enter 显示 103 APPROVED，然后是入账 webhook。
80/20 进度条是故事板中的示意分配。
示意余额
- USD25,000.00
- ARS250,000.00
- BRL184,200.00
- MXN310,500.00
余额只在此演示中按示例金额变动。
us
pa
sv此演示中的 USD：美国、巴拿马、秘鲁和萨尔瓦多。
POST /api/payin/
Authorization: Bearer <DEMO_TOKEN>
DEMO · 不会发送任何请求。此演示不会调用 Stage 或生产环境。
POST /api/payin/
模拟响应显示在这里
开发者
使用令牌化卡片扣款
用令牌代替卡片信息发送请求，并在后续扣款中重复使用该令牌。
- 各国卡品牌代码，例如墨西哥 Visa 为 1600
- Stage 提供测试卡，覆盖成功、拒绝和 3D Secure 场景
- 授权、退款和拒付均有 Webhook 通知
# 示意请求：字段已简化，完整规范请见 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": "CreditCard", "code": "1600", "flow": "DIRECT" }, "externalId": "3f9a6c1e-0000-4000-8000-000000000042", "country": "MEX", "currency": "MXN", "amount": 1250.00, "accountNumber": "<your-account-number>", "conceptCode": "0001", "merchant": { "type": "COMPANY", "name": "Comercio Ejemplo S.A. de C.V." }, "payer": { "type": "INDIVIDUAL", "name": "Lucía", "lastname": "Méndez", "document": { "type": "RFC", "id": "XAXX010101000" }, "email": "lucia.mendez@example.com" }, "card": { "token": "<card-token>" } }'
// 示意请求：字段已简化，完整规范请见 docs.localpayment.com const res = await fetch('https://api.stage.localpayment.com/api/payin/', { method: 'POST', headers: { Authorization: `Bearer ${accessToken}`, // from POST /api/token/ 'Content-Type': 'application/json', }, body: JSON.stringify({ paymentMethod: { type: 'CreditCard', code: '1600', flow: 'DIRECT' }, // Visa · Mexico externalId: crypto.randomUUID(), country: 'MEX', currency: 'MXN', amount: 1250.0, accountNumber: process.env.LP_ACCOUNT_NUMBER, conceptCode: '0001', merchant: { type: 'COMPANY', name: 'Comercio Ejemplo S.A. de C.V.' }, payer: { type: 'INDIVIDUAL', name: 'Lucía', lastname: 'Méndez', document: { type: 'RFC', id: 'XAXX010101000' }, email: 'lucia.mendez@example.com', }, card: { token: storedCardToken }, // 令牌来自 POST /api/card 或 Smart Fields }), }); const payin = await res.json(); // status.description: APPROVED, REJECTED…
常见问题
巴西支持银行卡收单吗？
不支持。银行卡收单覆盖阿根廷、哥伦比亚、墨西哥和秘鲁。在巴西，请使用 Pix 和 Pix 密钥虚拟账户收款，全天候数秒内确认。
可以受理哪些卡品牌？
四个市场均支持 Visa 和 Mastercard；阿根廷和哥伦比亚另支持 American Express 和 Diners Club。四个市场均支持借记卡。
3D Secure、分期付款和订阅在哪些市场可用？
哥伦比亚、墨西哥和秘鲁。分期付款仅适用于以当地货币支付的信用卡，因此在秘鲁仅限 PEN 支付。在阿根廷，可使用一次性支付、令牌化、退款和拒付管理。
拒付如何处理？
您会收到拒付 Webhook，并可在通知所列期限前通过 API 或 Business Portal 提交证据。如未按时提交，争议通常会判持卡人胜诉。
上线前可以测试银行卡流程吗？
可以。Stage 提供测试卡，覆盖成功、拒绝、3D Secure 验证和处理错误等场景，不涉及真实资金。
卡数据如何受到保护？
数据在传输中采用 TLS 1.2+ 加密，静态存储采用 AES-256 加密，并通过 AWS KMS 轮换密钥。Smart Fields 和托管收银台让原始卡数据不经过您的服务器。
可以保存卡片以便后续扣款吗？
可以。阿根廷、哥伦比亚、墨西哥和秘鲁支持令牌化。您只保存令牌而非卡号，之后用于复购或订阅扣款。
卡支付使用哪种货币？
卡支付以各市场当地货币（ARS、COP、MXN）扣款，秘鲁可用 PEN 或 USD，并按您的结算货币入账。