获取绑定Token列表

用于Token支付。商家可以通过这个接口，获取顾客绑定的卡信息。

Content-Type: application/json; charset=UTF-8 ❌
Content-Type: application/json ✅

请求参数

POST

名称	类型	长度	必填	签名	描述
merchantNo	String	20	Yes	Yes	商户号。 商户注册时，OnerWay 会为商户创建商户号
appId	String	20	No	Yes	商户应用程序 ID。 商户注册网站时，OnerWay 会为商户创建一个应用 id。不传时，默认查询商户号下所有绑定的 token 信息。传入时，查询指定 appId 下的绑定的 token 信息。
merchantCustId	String	50	Yes	Yes	客户在商户的唯一标识
subProductType	String	16	Yes	Yes	绑卡/订阅交易子产品类型： TOKEN - 绑卡 SUBSCRIBE - 订阅 默认为TOKEN
sign	String	/	Yes	No	签名字符串，请参阅签名接口

响应参数

名称	类型	描述
respCode	String	来自 Onerway 的响应码
respMsg	String	来自 Onerway 的响应信息
data	Object	响应数据。 请参阅对象 data

data

名称	类型	必填	描述
merchantNo	String	Yes	商户号。 商户注册时，OnerWay 会为商户创建商户号
tokenInfos	List	Yes	token明细列表。请参阅对象TokenInfo

TokenInfo

名称	类型	必填	描述
id	String	Yes	绑定信息id（可用于解绑操作）
tokenId	String	Yes	绑卡令牌id
appId	String	Yes	商户应用程序 ID。商户注册网站时，OnerWay会为商户创建一个应用id
cardNumber	String	Yes	加密后的卡号
paymentMethod	String	Yes	具体支付方式，包括卡和本地支付类型，
cardBinCountry	String	Yes	卡 Bin 国家
year	String	Yes	卡号年份
month	String	Yes	卡号月份

查询 Token 请求和响应示例

POST

查询 订阅 的 Token 信息：

请求参数

{
  "appId": "1831944691027152896",
  "merchantCustId": "custId_1640247522099",
  "merchantNo": "800209",
  "sign": "7ff2cf96a3d106084a02f8987ad695eaf21f11414addf10411958f297c7321e7",
  "subProductType": "SUBSCRIBE"
}

响应参数

{
  "respCode": "20000",
  "respMsg": "Success",
  "data": {
    "merchantNo": "800209",
    "tokenInfos": [
      {
        "id": "1853389154086916098",
        "tokenId": "de9c2cd941dcbcab643b6248298b071cf0e04000ef4752a576d1555a2d9ddee1",
        "appId": "1831944691027152896",
        "cardNumber": "400000******2701",
        "paymentMethod": "VISA",
        "cardBinCountry": "US",
        "year": "2026",
        "month": "05"
      },
      {
        "id": "1853384078811303938",
        "tokenId": "1e51d629bd0c919d016ac53ca1b34366e4870cd3f497c3ee13cd24bbdf5fcb68",
        "appId": "1831944691027152896",
        "cardNumber": "400000******2701",
        "paymentMethod": "VISA",
        "cardBinCountry": "US",
        "year": "2026",
        "month": "05"
      },
      {
        "id": "1853376375024095234",
        "tokenId": "4e7b29c2d691d8bb47f73bc60e20988e577d426a5d842bb971dfe5c3e10d0913",
        "appId": "1831944691027152896",
        "cardNumber": "400000******2701",
        "paymentMethod": "VISA",
        "cardBinCountry": "US",
        "year": "2026",
        "month": "05"
      }
    ]
  }
}

查询 绑卡 的 Token 信息：

请求参数

{
  "appId": "1727880846378401792",
  "merchantCustId": "custId_1640247522000",
  "merchantNo": "800209",
  "sign": "e4a2e973bb7d26ae592c95d3e13eaca0a28f4ab92e1a0576cf7d3fdbe1703835",
  "subProductType": "TOKEN"
}

响应参数

{
  "respCode": "20000",
  "respMsg": "Success",
  "data": {
    "merchantNo": "800209",
    "tokenInfos": [
      {
        "id": "1744642154859945986",
        "tokenId": "f3a3e62026eab515003c3ee30ebf32386dbf6feb20fc556f3e2646b85ab5347d",
        "appId": "1727880846378401792",
        "cardNumber": "400002******0961",
        "paymentMethod": "VISA",
        "cardBinCountry": "US",
        "year": "2024",
        "month": "05"
      }
    ]
  }
}

此示例仅限参考 请勿拿此示例直接请求。