绑卡及额度试算 - qianlongjinrong/Shoujidai-Yundaitong GitHub Wiki

1、绑卡申请接口

  • [接口说明]

合作机构将用户的银行卡信息推送给手机贷做绑卡处理。方可做后续的借贷操作。

对于走借贷流程的用户,该服务必须要调用,并且可根据合作需要,异步返回用户的产品额度信息。

手机贷根据商户合作要求,绑卡结果支持同步和异步回调通知返回,异步调用接口请参考《需合作机构方提供的接口中的操作结果回调接口》中的实现,提供给手机贷调用。

本接口仅可接受单张绑卡。

本接口可根据合作需要选择性调用。

  • [技术要求]

接口采用HTTP POST方式,数据组织采用JSON传递。

  • [服务名称] bindBankCard
  • [请求业务数据报文-reqData参数说明]
参数名称 类型 是否必填 说明
userCode String(32) 手机贷分配的用户编号。有调用同步用户信息接口生成返回。
cardNum String(20) 银行卡号
bankName String(16) 开户行的银行名称例如:中国银行
phoneNum String(11) 申预留移动手机号有效长度为11位,不要带国际区号+86。
  • [响应业务数据报文-data参数说明]
参数名称 类型 是否必填 说明
bindStatus int(1) 绑卡状态0、绑定失败1、绑定成功2、绑定中如果合作要求是异步返回绑卡结果,则bindStatus=2。同步处理则按实际绑定状态返回。
  • 【请求报文示例】
{
    "userCode": "20170629526131",
    "cardNum": "6217002340099022",
    "bankName": "上海浦发发展银行",
    "phoneNum": "15352645215"
}

  • 【响应报文示例】
{
    "bindStatus": 2
}