Onerway
线上支付

支付方式概览

卡、钱包与本地支付方式三类支付方式的划分、各接入方式对它们的支持情况,以及展示支付方式前的可用性查询规则。

Onerway 支持的支付方式分为三类:卡(Visa、Mastercard 等卡组织的信用卡与借记卡)、钱包(Apple Pay、Google Pay)与本地支付方式(各国家或地区的银行转账、电子钱包、先买后付等)。

本栏目按支付方式说明接入准备、各接入方式的差异与专属流程。接入方式自身的流程见收银台接入、Web SDK 接入与 API 直连接入;保存支付方式、订阅、预授权等业务场景见支付场景。

各接入方式的支持情况

支付方式收银台Web SDKAPI 直连
卡由收银台采集卡信息由 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 通知。