Onerway
POST

查询可用支付方式

该接口用于在创建支付前,根据客户国家或地区、币种、金额、支付发起环境和商户开通配置查询可用支付方式。

请求

appId
Onerway 分配给商户应用或站点的标识,用于识别发起查询的应用。
示例:
country
客户所在国家或地区代码,使用 ISO 3166-1 alpha-2 两位字母代码,用于匹配该地区可用的支付方式。
示例:
merchantNo
Onerway 分配的商户号;获取方式参见接入准备。
示例:
orderAmount
订单金额,使用与 orderCurrency 对应的十进制字符串;格式与最小金额要求详见币种与金额校验。
示例:
orderCurrency
订单币种,使用 ISO 4217 三位字母代码,需与 orderAmount 匹配。
示例:
osType
条件:当 paymentMode 不是 WEB 时必填。
移动端或 App 场景下的操作系统类型。
示例:
可选值
IOS
iOS 设备。
ANDROID
Android 设备。
paymentMode
交易平台或环境的支付模式;不传时默认按 WEB 处理。
示例:
可选值
WEB
桌面浏览器支付。
APP
原生移动 App 支付;使用该模式时需同时传入 osType。
WAP
移动浏览器支付;使用该模式时需同时传入 osType。
sign
请求签名字符串;生成方式详见请求签名。
subProductType
支付方式类别过滤条件;传入后仅返回支持该交易处理模式的支付方式,不传则按其他订单参数返回可用方式。
示例:
可选值
DIRECT
直接支付。
SUBSCRIBE
订阅支付。
INSTALLMENT
分期支付。
约束
一致性
共享枚举仅表示值域字典;实际可用值仍取决于产品兼容性、商户开通配置和本次订单上下文。

请求示例

curl -X POST 'https://sandbox-acq.onerway.com/v1/txn/consultPaymentMethod' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "appId": "replace_with_app_id",
  "country": "US",
  "merchantNo": "replace_with_merchant_no",
  "orderAmount": "99.99",
  "orderCurrency": "USD",
  "osType": "IOS",
  "paymentMode": "APP",
  "sign": "{{SIGN}}",
  "subProductType": "DIRECT"
}'

响应

respCode
Onerway 返回的请求处理结果代码;20000 表示请求处理成功,其他代码表示失败或异常。完整码表见响应码。
respMsg
请求处理结果的可读说明。
可用于当前订单上下文的支付方式列表。

响应示例

示例代码暂不可用。

该接口暂未记录错误响应。