开放文档

外观

三方支付

约 2791 字大约 8 分钟

会员办理接口三方支付

2026-4-02

提示

三方支付产品与运营商产品的订购逻辑类似，最大的区别在于 三方支付产品需要用户提供姓名、证件号、卡号等信息申请签约验证（收验证码），然后提交签约完成产品订购。

页面要求

  • 页面上需要用户手动勾选支付协议，协议内容见附件。
  • 渠道方需按照要求设计页面，并提供链接进行页面报备。

对接流程

接口列表

（普通绑卡）收验证码

接口地址: /wy-cel-open/api/member/handle/send-sms

请求方式: POST

请求数据类型: application/json

接口描述: 与运营商产品的发验证码类似，该环节需要提供个人信息进行签约申请，调用成功后会发送验证码到预留手机号，下一步签约验证时提供验证码等信息。

请求参数:

参数名称参数说明是否必须数据类型说明
appId系统标识truestring
sign签名truestring
data会员办理发短信入参trueobjectSendSmsReq
  phone号码truestring
  productId产品编码truestring分配的推广编码
  pan银行卡号truestring如：6222001234567890
  cardHolderName持卡人姓名（与银行预留一致）truestring如：张三
  cardHolderId身份证号truestring如：110101199001011234
  phoneNo银行预留手机号truestring通常与办理手机号一致
  expiredDate卡有效期（MMYY 格式，信用卡必填）falsestring如：1225
  cvv2卡校验码/CVV2（信用卡背面签名栏后 3 位数字）falsestring如：123

响应参数:

参数名称参数说明类型说明
code状态码integer
message描述string
dataobjectSmsResp
  smsKey短信key
有返回则提交时必须带上		string
  success状态boolean
  msg原因string

请求示例:

{
  "appId": "",
  "sign": "",
  "data": {
    "phone": "1234567890",
    "productId": "1752994995226415200",
    "pan": "6222001234567890",
    "cardHolderName": "张三",
    "cardHolderId": "110101199001011234",
    "phoneNo": "1234567890",
    "expiredDate": "1225",
    "cvv2": "123"
  }
}

响应示例:

// 接口调用异常
{
  "code": 500,
  "message": "签名失败"
}
// 短信发送失败
{
  "code": 0,
  "message": "",
  "data": {
    "smsKey": "",
    "success": false,
    "msg": "用户无权限办理"
  }
}
// 短信发送成功
{
  "code": 0,
  "message": "",
  "data": {
    "smsKey": "",
    "success": true
  }
}

（普通绑卡）提交办理

接口还是走 办理接口，只是smsKey传值的时需要对值做一下处理：

  • 普通绑卡：smsKey的值为签约申请（收验证码）返回的smsKey，smsCode为用户收到的真实验证码。
  • 一键绑卡：不涉及该接口，无需提交办理这一步。

警告

提交办理的时候，务必传入notifyUrl接收通知，来确定用户是否办理完成。

（一键绑卡）跳转签约

接口地址: /wy-cel-open/api/member/handle/fast-bind

请求方式: POST

请求数据类型: application/json

接口描述: 提供个人信息进行一键绑卡申请，调用成功会返回跳转地址，前端需要通过form表单进行跳转签约。

请求参数:

参数名称参数说明是否必须数据类型说明
appId系统标识truestring
sign签名truestring
data一键绑卡签约入参trueobjectComboFastBindParam
  phone号码truestring
  productId产品编码truestring分配的推广编码
  cardHolderName持卡人姓名（与银行预留一致）truestring如：张三
  cardType银行卡类型：
0001信用卡
0002借记卡		truestring默认0001
  bankId银行代码truestring
  idType证件类型falsestring默认身份证
  cardHolderId身份证号truestring如：110101199001011234
  phoneNo银行预留手机号truestring通常与办理手机号一致
  clbckUrl绑卡回跳地址truestring绑卡成功后跳回的页面地址
  sourceIp客户端 IP 地址
不能，不能，不能填写固定IP		truestring如：101.178.108.13
  tr3Url异步通知地址falsestring接收签约结果的通知地址
  reMark备注信息falsestring
  channelTxId渠道订单号truestring
  notifyUrl办理通知地址truestring办理结果通知地址
  adPlatform投放引擎名称truestring如：广点通
  appName应用名称truestring如：某某理财APP
  appPackage办理App包名
不为空且为英文字符串		truestring如：com.kuaishou.nebula
  sourceUrl办理页面链接truestring
  snapshotUrl办理页面快照链接falsestring
  imageUrls办理页面快照图片链接falsestring
证件类型
证件类型编码
身份证类型0
护照类型1
军官证2
士兵证3
港澳台通行证4
临时身份证5
户口本6
其他类型证件7
警官证9
外国人居留证12
回乡证15
企业营业执照16
法人代码证17
台胞证18
外国人永久居留身份证19

响应参数:

参数名称参数说明类型说明
code状态码integer
message描述string
dataobjectSmsResp
  success状态boolean
  msg失败原因string
  rdrctType跳转方式integer默认：0
0：拼接rdrctUrl和signMsg以form方式提交
1：返回的rdrctUrl已经是form表单，插入DOM触发提交
2: script 跳转页：DOMParser 解析后立即执行
3：纯 URL：直接 location.href 跳转
  rdrctUrl用于跳转银行界面地址string
  signMsg一键绑卡秘钥string用于请求银行跳转地址赋值参数名epccGwMsg，
将参数名通过form表单POST提交至rdrctUrl地址
  status状态:
0-未处理
1-处理中
2-成功
3-失败		string
  bindId一键绑卡标识string签约通知会携带
  orderId我方订单IDstring订单状态通知会携带

请求示例:

{
  "appId": "",
  "sign": "",
  "data": {
    "phone": "1234567890",
    "productId": "1752994995226415200",
    "cardHolderName": "张三",
    "idType": "0",
    "cardHolderId": "110101199001011234",
    "phoneNo": "1234567890",
    "cardType": "0002",
    "bankId": "ABC",
    "clbckUrl": "http://localhost:9985/oeh/mall/clb",
    "tr3Url": "http://localhost:8080/api/callback/fast-bind-card/1",
    "sourceIp": "192.168.1.1",
    "appName": "某某理财 APP",
    "reMark": "签约备注",
    "channelTxId": "",
    "notifyUrl": "http://localhost:8080/api/callback/fast-bind-card/2",
    "adPlatform": "",
    "appPackage": "",
    "sourceUrl": "",
    "snapshotUrl": "",
    "imageUrls": ""
  }
}

响应示例:

// 接口调用异常
{
  "code": 500,
  "message": "签名失败"
}
// 申请签约失败
{
  "code": 0,
  "message": "",
  "data": {
    "success": false,
    "msg": "失败原因",
    "rdrctType": 0,
    "rdrctUrl": "http://localhost:9985/oeh/mall/clb",
    "signMsg": "xx",
    "orderId": "",
    "bindId": ""
  }
}
// 申请签约成功
{
  "code": 0,
  "message": "",
  "data": {
    "success": true,
    "msg": "",
    "rdrctType": 0,
    "rdrctUrl": "http://localhost:9985/oeh/mall/clb",
    "signMsg": "xx",
    "orderId": "12345",
    "bindId": ""
  }
}

rdrctType: 0前端跳转银行签约页面示例代码参考：

// 前端参考以下代码通过form表单方式带参epccGwMsg（值取自signMsg）post请求rdrctUrl

let jumpBtn = $("#jumpToBankBtn")
if (jumpBtn.css("display") === "none") {
    jumpBtn.css("display", "inline-block")
}
// 回跳地址
let rdrctUrl = jsonCode["responseBody"]["rdrctUrl"]
let signMsg = jsonCode["responseBody"]["signMsg"]
console.log("rdrctUrl:" + rdrctUrl)
console.log("signMsg:" + signMsg)
if (isEmpty(rdrctUrl) || isEmpty(signMsg)) {
    console.log("disablew")
    // 跳转按钮disabled
    jumpBtn.attr("disabled", true)
} else {
    jumpBtn.attr("disabled", false)
    $("#jumpToBankForm").attr("action", rdrctUrl)
    $("#epccGwMsg").attr("value", signMsg)
}

function jumpPageToBank() {
    $("#jumpToBankForm").submit()
}

<form id="jumpToBankForm" target="_blank" method="post" style="display: none" action="">
    <label>
        <input type="text" id="epccGwMsg" name="epccGwMsg" value="">
    </label>
</form>

（一键绑卡）签约通知

接口地址: 接入方提供（tr3Url）

请求方式: POST

请求数据类型: application/json

接口描述: 签约申请（跳转签约）时传入的tr3Url会在用户确定签约后发起通知，不代表扣费办理成功。

请求参数:

参数名称参数说明是否必须数据类型说明
status一键绑卡状态：
0-未处理
1-处理中
2-成功
3-失败		trueint
bindId一键绑卡标识truestring如：12345

响应参数: 字符串的ok或error

请求示例:

{
  "status": 1,
  "bindId": "12345"
}

响应示例:

// 成功
ok

// 失败
error

办理通知（notifyUrl）

无论是普通绑卡还是一键绑卡，都以办理通知结果为准，参数结构见 状态通知

附件

KQ

银行快捷协议-V1.0（2025）.xlsx

BankId.xlsx

一键绑卡受理能力 -202603V1.2.xlsx

HLB

资料名称版本下载链接说明
快捷支持银行+限额 (主流银行)20260525快捷支持银行（含一键绑卡）-主流银行260525.zip点击下载
快捷支持银行+限额 (非主流银行)20260525快捷支持银行（含一键绑卡）-非主流银行260525.zip点击下载
银行用户协议支付001001-银行用户协议支付.zip挂载同意协议，必须让用户点击确认，不能默认勾选
合利宝快捷支付协议001快捷支付服务协议.zip挂载同意协议，必须让用户点击确认，不能默认勾选
银行编码表001银行编码列表.zip点击下载

Copyright © 2025 - 北京觉观科技有限公司