跳到正文
开灵科技 - 北京开灵科技有限公司API百宝箱

㉕ 批量付款开票 ★ 扳机

⑧ 付款 是一单一付,老板每天几十单就要点几十次 U 盾。 本接口一次勾多笔订单、生成一张批量支付页、老板签一次全付完,票也一起开出来。 页面类:POST 进 → 拿 pageUrl → 跳过去。

批量付款之后会发生什么(业务)

  1. 先按老规矩把每一笔都走 ⑦ 下单(预下单),拿到各自的 outOrderId。
  2. 把要一起付的订单号装进 orderInfo 数组,调本接口 → 拿 pageUrl → 跳工行批量支付页。
  3. 老板在页面上做一次实名签(U 盾 / 人脸),这一批全部付款成功。
  4. 工行逐笔自动开票 + 缴税 + 把货款打给各个散户,你们不用再调任何接口。
  5. 结果仍然是按单回来:走 ⑨ 开票通知回调,或用 ⑩ 查开票状态 逐单查。

接口

POST  https://openapi.kailingteck.com/api/v1/icbc/order/batch-pay

鉴权:X-App-Key + X-Sign + X-Timestamp。

请求参数(工行全字段 · 原样传)

工行字段必填大白话说明
appId中台填平台编号(开灵自动填,你不用传)
verifiedCode中台填机构编码(平台自营下必输;开灵从配置注入)
ukeyId中台填U盾 ID(平台自营下必输;开灵从配置注入)
orderInfo必填订单列表,数组,最多 5 笔一批。字段见下表
trxChannel选填交易渠道:01-PC / 02-移动端 / 03-H5
payJumpUrl选填批量付款完成后跳回你们页面的地址

orderInfo 订单信息(数组)

工行字段必填大白话说明
outOrderId必填合作方订单 ID(要和 ⑦ 下单时传的一致)
outVendorId选填收方编号
outUserId选填付方编号
{
  "trxChannel": "01",
  "payJumpUrl": "https://your-site.com/pay/done",
  "orderInfo": [
    { "outOrderId": "KLORD20260824001", "outVendorId": "562526", "outUserId": "KL20260824001" },
    { "outOrderId": "KLORD20260824002", "outVendorId": "562526", "outUserId": "KL20260824002" }
  ]
}

返回

{ "code": "CYT_00000", "data": { "pageUrl": "https://…/redirect/rxxx", "mock": false } }

页面类:前端 location.href = pageUrl 跳工行批量支付页。

注意

  • 一批最多 5 笔(工行 orderInfo 长度上限)。超过 5 笔就分批发。
  • 批量页只是「一次签、一起付」,开票和回调还是按单走,别在业务里当成一张大票处理。
  • 批量里某一笔额度不够会单笔失败,拿 ㉓ 发票上传重试 单独补。
  • 发起前建议先用 ㉑ 查还能开多少票 确认这一批的总金额和张数都够。