灵工系统-对外文档
    灵工系统-对外文档
    • 产品说明
    • 接入说明
    • 返回状态码
    • 常见问题
    • 签名规则
      • MD5签名规则
      • RSA签名规则
    • 接口详情
      • 1 签约
        • 1.1 小程序/H5签约API
        • 1.2 静默签API
        • 1.3 签署结果查询API
        • 1.4 签约异步通知API
        • 1.5 催签API
        • 1.6 人员信息查询
        • 1.8 删除用户签约信息
      • 2 发放
        • 2.1 佣金发放API
        • 2.2 订单交易明细查询API
        • 2.3 订单回单(成功)分页查询API
        • 2.4 发放异步通知API
        • 2.5 退票异步通知API
        • 2.6 查询用户限额情况
        • 2.7 个税测算
      • 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 银行卡号查询所属银行

    常见问题

    问题目录#

    1.
    API发放单笔限额
    2.
    单人单月限额
    3.
    orderId、bizOrderNo、detailOrderNo的区别

    问题详情#

    1.API发放单笔限额#

    API 打款时,银行卡单笔最低0.01元,最高49999元。支付宝单笔最低0.1元,最高49999元。微信单笔最低0.3元,最高20000元。除微信外,若单笔超过49999元,请分两次提交支付单。

    2.单人单月限额#

    单人单月限额取决于服务商和支付通道限制。两者以最低额度为准。原则上,银行卡和支付宝没有支付上限,其上限取决于服务商单人单月限额。微信通道的限额,取决于微信官方限制,请看下图
    bd4f4673f33e519b675dbf680be5c55c.png

    3.orderId、bizOrderNo、detailOrderNo的区别#

    orderId:每次请求唯一标识,必须不一样,用于后期出现问题双方定位,以及幂等(请求幂等)
    bizOrderNo:批次订单号,你方用来判断是哪个批次,查询和回调回原样返回(业务幂等)
    detailOrderNo:单笔订单号,你方用来判断具体哪笔明细,用于你方判断哪笔是否成功,如同一个人两笔10元,一笔成功一笔失败,你可以知道具体哪笔成功哪笔失败

    4.在交易处理中,哪些情况不能直接认定为交易成功或失败?#

    只有交易状态明确返回“成功”时,才能视为交易成功;只有明确返回“失败”时,才能视为交易失败。
    如以下几种情况不能直接认定为交易成功或失败:
    接口超时或网络异常:需重试发起请求打款或查询,不可直接判为失败;
    查询订单不存在:需重试发起请求查询,可能为信息延迟;
    银行处理中:状态为“支付中”,需等待后续异步通知或主动查询。

    5.对于非明确状态应如何处理?#

    除明确成功或失败外,其余状态(如支付中、接口超时、查询订单不存在等)均属于中间状态或异常情况。此类交易需标记为“支付中”或“异常”,建议通过重试请求或线下对账进一步确认最终结果,不可轻易认定为失败或成功。
    上一页
    返回状态码
    下一页
    MD5签名规则
    Built with