银行卡
受理银行卡支付，收银流程贴合本地市场。
在阿根廷、哥伦比亚、墨西哥和秘鲁受理 Visa 和 Mastercard，并在文档列明的市场受理 American Express、Diners Club、Naranja 和 Cabal。一次集成即可完成卡片令牌化存储、3D Secure 验证、分期付款和拒付管理。
- 阿根廷 · 哥伦比亚 · 墨西哥 · 秘鲁
- Visa、Mastercard、Amex、Diners、Naranja、Cabal
- 秘鲁支持 PEN 和 USD
阿根廷 · 哥伦比亚 · 墨西哥 · 秘鲁- PCI DSS v4.0.1
- SOC 2 Type II
- ISO 27001
- AML/KYC
- TLS 1.2+ · AES-256
- 国家：阿根廷、哥伦比亚、墨西哥和秘鲁
- 4
- 卡品牌：Visa、Mastercard、Amex、Diners、Naranja 和 Cabal
- 6
- 哥伦比亚、墨西哥和秘鲁
- 3D Secure
- 哥伦比亚、墨西哥和秘鲁
- 分期付款
卡组织
国际卡组织，加上消费者常用的本地卡
四个市场均支持 Visa 和 Mastercard；阿根廷另支持 American Express、Naranja 和 Cabal，哥伦比亚另支持 American Express 和 Diners Club，涵盖信用卡和借记卡。
逐个市场
各国可用功能
银行卡功能因市场而异。以下为目前文档所涵盖的内容。
阿根廷
- 一次性支付
- ✓
- 令牌化
- ✓
- 退款
- ✓
- 拒付
- ✓
- 3DS
- —
- 分期付款
- —
- 订阅
- —
哥伦比亚
- 一次性支付
- ✓
- 令牌化
- ✓
- 退款
- ✓
- 拒付
- ✓
- 3DS
- ✓
- 分期付款
- ✓
- 订阅
- ✓
墨西哥
- 一次性支付
- ✓
- 令牌化
- ✓
- 退款
- ✓
- 拒付
- ✓
- 3DS
- ✓
- 分期付款
- ✓
- 订阅
- ✓
秘鲁
- 一次性支付
- ✓
- 令牌化
- ✓
- 退款
- ✓
- 拒付
- ✓
- 3DS
- ✓
- 分期付款
- ✓
- 订阅
- ✓
来源：docs.localpayment.com。巴西不提供银行卡收单，请使用 Pix 和 Pix 密钥虚拟账户。
功能
银行卡受理所需的一切
令牌化与存卡
用令牌代替卡片数据，服务回头客、加快复购并支持订阅。
3D Secure
哥伦比亚、墨西哥和秘鲁支持强客户认证。发卡行要求验证时，API 会返回验证页面 URL。
分期付款
先获取分期方案报价，由客户选择后扣款；适用于哥伦比亚、墨西哥和秘鲁以当地货币支付的信用卡（秘鲁仅限 PEN）。
预授权与请款
先授权、后请款；订单取消时可释放冻结金额。各市场的可用性在入驻时确认。
退款
通过 API 或 Business Portal 办理银行卡退款，并下载付款凭证。
拒付管理
接收拒付 Webhook，并在答复期限内通过 API 上传证据。
风控
3D Secure、BIN 白名单与拒付管理
多层管控，帮助您在可疑交易演变为拒付之前将其拦截。
3D Secure
在哥伦比亚、墨西哥和秘鲁验证持卡人身份。发卡行发起验证时，API 会返回验证 URL。
BIN 白名单
在 Business Portal 中按发卡行和卡类型设置预先批准的 BIN，仅受理这些卡段。
拒付管理
每笔拒付都会收到 Webhook 通知，并可在截止日期前通过 API 或 Business Portal 上传证据。
PCI 范围
让原始卡数据远离您的服务器
通过 Smart Fields、嵌入式 iframe 或 WebCheckout 采集卡信息。卡数据在我们托管的输入框中录入，并转换为令牌，由您的后端随收款请求一并发送。
- Smart Fields：通过 JS SDK 在您自己的界面中嵌入托管卡字段
- 嵌入式 iframe：白标收银台，PCI 范围更小
- WebCheckout 与支付链接：无需编码，PCI 范围最小
- 传输中采用 TLS 1.2+，静态数据采用 AES-256，并通过 AWS KMS 轮换密钥
工作原理
一笔银行卡支付的流程
- 01
采集
客户在 Smart Fields 或托管收银台中输入卡信息，或直接使用已保存的令牌。
- 02
授权
调用 POST /api/payin/，paymentMethod.type 设为 CreditCard，并填入该国的卡品牌代码。
- 03
按需验证
如果发卡行要求 3D Secure，请将客户重定向到响应中的验证 URL。
- 04
确认
结果实时返回，并通过签名 Webhook 通知，可直接用于发货和对账。
开发者
使用令牌化卡片扣款
用令牌代替卡片信息发送请求，并在后续扣款中重复使用该令牌。
- 各国卡品牌代码，例如墨西哥 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>" }
}'常见问题
巴西支持银行卡收单吗？
不支持。银行卡收单覆盖阿根廷、哥伦比亚、墨西哥和秘鲁。在巴西，请使用 Pix 和 Pix 密钥虚拟账户收款，全天候数秒内确认。
可以受理哪些卡品牌？
四个市场均支持 Visa 和 Mastercard；阿根廷另支持 American Express、Naranja 和 Cabal，哥伦比亚另支持 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，并按您的结算货币入账。