灵工系统-对外文档
  1. 1 签约
灵工系统-对外文档
灵工系统-接口文档
  • 灵工系统-接口文档
  • 产品说明
  • 接入说明
  • 返回状态码
  • 常见问题
  • 签名规则
    • MD5签名规则
    • RSA签名规则
  • 接口详情
    • 1 签约
      • 1.1 小程序/H5签约API
        POST
      • 1.2 静默签API
        POST
      • 1.3 签署结果查询API
        GET
      • 1.4 签约异步通知API
        POST
      • 1.5 催签API
        POST
      • 1.6 人员信息查询
        GET
      • 1.7 校验用户并签约
        POST
      • 1.8 删除用户签约信息
        POST
    • 2 发放
      • 2.1 委托代征佣金发放API
      • 2.2 订单交易明细查询API
      • 2.3 订单回单(成功)分页查询API
      • 2.4 发放异步通知API
      • 2.5 退票异步通知API
      • 2.6 查询用户限额情况
    • 3 任务
      • 3.1 创建任务API
      • 3.2 任务列表查询API
      • 3.3 任务审核异步通知API
    • 4 开票
      • 4.1 查询开票类目API
      • 4.2 开票申请API
      • 4.3 查询开票信息API
      • 4.4 开票异步通知API
      • 4.5 开票账户查询API
    • 5 账户
      • 5.1 余额查询API
      • 5.2 充值异步通知API
      • 5.3 划拨异步通知API
    • 6 同步
      • 6.1 灵工签约合同
      • 6.2 发放订单数据
      • 6.3发放流水回单
      • 6.4 充值流水
    • 7 其他
      • 7.1 银行卡号查询所属银行
  1. 1 签约

1.1 小程序/H5签约API

POST
/merchant/exportApi/sign/sign
签约API接口
进行签约时,需要进行姓名、身份证二要素校验,必须保证为同一人才可以签约。传入成功后将对用户手机号发送通知短信,通过通知短信内短链进入H5或者小程序完成合同签署。建议签约前自行进行运营商三要素校验(即手机号,姓名,身份证号一致性校验)

请求参数

Header 参数
merchantNo
string 
商户编号
必需
默认值:
{{merchantNo}}
agreementId
string 
协议编号
必需
默认值:
{{agreementId}}
appKey
string 
appKey
必需
默认值:
{{appKey}}
requireTime
string 
必需
请求时间格式(yyyy-MM-dd HH:mm:ss)
默认值:
{{$date.now}}
sign
string 
签名
必需
默认值:
{{sign}}
signType
string 
必需
签名类型 MD5/RSA
默认值:
{{signType}}
orderId
string 
必需
每个 request 的 id,要求每次请求的 id 不一样,会在response 中原样返回
默认值:
{{$number.int}}
Body 参数application/json
bankCardNo
string 
银行卡号
可选
示例值:
62234258676607630
callbackUrl
string 
可选
回调地址,为空则使用默认回调地址
callbackUrlType
integer <int32>
可选
回调地址类型 1H5 2小程序 3自定义回调】
cardType
integer <int32>
可选
证件类型 1身份证 2护照 3香港通 4澳门通 5台湾通
示例值:
4332238932828
idCard
string 
证件号
必需
示例值:
420625200210173300
idCardBack
string 
证件反面照片
可选
idCardFront
string 
证件正面照片
可选
mobile
string 
手机号
必需
示例值:
132239022321
name
string 
姓名
必需
示例值:
张三
remark
string 
备注
可选
示例值:
测试签约人员
skipUser
string 
可选
是否跳过身份校验 0否 1是
useSign
integer <int32>
可选
签约模式,默认协议配置一致 1小程序 4静默签 5H5签约】
示例
{
    "bankCardNo": "62234258676607630",
    "callbackUrl": "https://fatherly-awareness.info/",
    "callbackUrlType": 1,
    "cardType": 1,
    "idCard": "420625200210173300",
    "idCardBack": "350100197005016966",
    "idCardFront": "12010019691027188X",
    "mobile": "132239022321",
    "name": "张三",
    "remark": "测试签约人员",
    "skipUser": "1",
    "useSign": 1
}

返回响应

🟢200成功
*/*
OK
Body
code
integer <int32>
返回码
可选
data
object 
返回数据
可选
msg
string 
返回信息
可选
示例
{
    "code": "200",
    "msg": "请求成功",
    "data": {
        "contractId": "94736783463487",
        "signUrl": "http://sdfsfsfsfds.com/sdfsdfidsdi"
    }
}
上一页
RSA签名规则
下一页
1.2 静默签API
Built with