灵工系统-对外文档
    灵工系统-对外文档
    灵工系统-接口文档
    • 灵工系统-接口文档
    • 产品说明
    • 接入说明
    • 返回状态码
    • 常见问题
    • 签名规则
      • MD5签名规则
      • RSA签名规则
    • 接口详情
      • 1 签约
        • 1.1 小程序/H5签约API
        • 1.2 静默签API
        • 1.3 签署结果查询API
        • 1.4 签约异步通知API
        • 1.5 催签API
        • 1.6 人员信息查询
        • 1.7 校验用户并签约
        • 1.8 删除用户签约信息
      • 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 接入方式#

    商户网站系统和支付系统之间通过http/https协议来进行通信:
    报文编码格式为UTF-8。
    接口以URL的形式提供以POST/GET的请求方式处理,请求参数与响应参数详见接口详情。
    公钥(appKey)、密钥(secretKey)等请求参数请联系技术支持提供。

    2 环境区分#

    生产环境:生产环境域名,请联系平台运营提供(若曾经对接过本系统,仅需替换参数即可)
    沙箱环境:沙箱环境域名,请联系技术支持提供(若曾未对接过本系统,务必在沙箱环境根据自身需求进行系列测试)

    3 对接demo#

    Java开发Demo下载
    PHP开发Demo下载

    4 Header请求参数#

    参数名称类型参数说明必填
    orderIdString每个 request 的 id,要求每次请求的 id 不一样,会在response 中原样返回是
    merchantNoString商户编号是
    agreementIdString协议ID是
    appKeyStringappKey是
    requireTimeString请求时间格式(yyyy-MM-dd HH:mm:ss)是
    signString签名是
    signTypeString签名类型 MD5/RSA是

    5 签名说明#

    MD5签名:demo中的SignEncryUtil为MD5签名工具类,有两个加密生成签名方法,GET请求方式时使用encrySignGet,POST请求方式时使用encrySignPost ,具体使用请参考“MD5签名规则”
    RSA签名:demo中的SaasApiRsaUtil为RSA签名及数据传输加解密工具类,具体使用请参考“RSA签名规则”。

    6 公共响应参数#

    参数名称类型参数说明必填
    codeint状态码,200表示成功是
    msgString信息是
    dataObject状态信息否

    7 异步通知#

    目前系统支持以下业务回调:
    发放异步通知
    签约异步通知
    充值异步通知
    退票通知 
    任务审核
    发票状态变动
    回调格式如下:
    {"data":{"参数字段名":"参数值"},"tab":业务类型}
    //回调使用同一个回调地址,根据类型判断回调业务和解析业务内容体,详见各接口示例。
    上一页
    产品说明
    下一页
    返回状态码
    Built with