Onerway 支持的支付方式分为三类:卡(Visa、Mastercard 等卡组织的信用卡与借记卡)、钱包(Apple Pay、Google Pay)与本地支付方式(各国家或地区的银行转账、电子钱包、先买后付等)。
本栏目按支付方式说明接入准备、各接入方式的差异与专属流程。接入方式自身的流程见收银台接入、Web SDK 接入与 API 直连接入;保存支付方式、订阅、预授权等业务场景见支付场景。
各接入方式的支持情况
| 支付方式 | 收银台 | Web SDK | API 直连 |
|---|---|---|---|
| 卡 | 由收银台采集卡信息 | 由 SDK 表单采集卡信息 | 商户自行采集卡信息或以卡 token 支付,需 PCI DSS |
| Apple Pay 钱包 | 收银台渲染按钮,域名验证由 Onerway 完成 | SDK 在商户页面内渲染按钮,商户域名需完成验证 | 商户自建按钮,商户域名需完成验证;加密 token 由 Onerway 代解密或商户自解密 |
| Google Pay 钱包 | 收银台渲染按钮 | SDK 在商户页面内渲染按钮 | 商户自行加载 Google Pay JS SDK;加密 token 由 Onerway 代解密或商户自解密 |
| 本地支付方式 | 收银台展示可用方式,或锁定单一方式 | SDK 展示可用方式 | 传 productType=LPMS 与 lpmsInfo,按 actionType 承接跳转、二维码或上下文展示 |
收银台与 Web SDK 路径下,钱包 token 与本地支付方式的跳转都由 Onerway 页面或 SDK 处理,商户系统不接触支付凭证;API 直连路径下,钱包与本地支付方式的参数差异见对应页面。
先查询可用支付方式
支付方式是否可用取决于商户开通配置、客户所在国家或地区、币种与金额,不能只按币种判断。展示支付方式前,先调用查询可用支付方式按当前订单上下文筛选,并缓存结果、在配置变更时刷新;币种与金额的校验规则见币种与金额校验。
查询结果中钱包记录的 productType 为 LPMS,仅用于分类;通过 API 直连发起钱包支付时固定传 productType=CARD 与 subProductType=DIRECT。钱包记录同时返回前端初始化所需的配置:ApplePay 与 GooglePay 都可能返回 countryCode、subCardTypes、gatewayName 与 merchantId,gatewayMerchantId 只有 GooglePay 返回;取值方式见各钱包页面。
通知中的支付方式
支付结果通知以 paymentMethod 返回本次实际扣款的支付方式,钱包交易可能另外返回 walletTypeName。这两个字段各自承载哪一层信息因钱包而异,需要识别具体支付方式时请同时读取;walletTypeName 有取值列表,paymentMethod 随实际扣款渠道返回、不预设取值范围。通知的验签、应答与状态判断见 Webhook 通知。