反向开票 · 订单交易接口

每次请求携带:X-App-Key(平台分配)、X-Timestamp(Unix 秒,±300 秒内)、X-Sign = SHA256(app_key + timestamp + body + app_secret) 16 进制小写。 与发票查验、反向开票(腾讯系)完全同一套签名,已接入过任一能力可直接复用。

• 创建反向订单:按订单金额(明细行金额合计)乘以合同约定费率计费,订单受理成功(code=10000 返回订单号)才计费,失败不计费;
• 其余接口(查询/审核/取消/重试/红冲)全部免费,不限次数;
• 费用从账户余额中扣减,商户中心可实时查看每笔费用与余额。

1. 前置:完成 乐企开通,并维护好营业员(含开票员)、商品库(远程收款还需维护供应商);
2. 调 order_create 创建订单,取 payment_invoice_qr_code_url 生成收款二维码给自然人扫码;
3. 自然人在支付宝内确认订单→(企业配置了审核时,调 order_audit 审核,仅可改单价/数量/金额三选二)→自然人收款,缴税、开票自动完成;
4. 轮询 order_query,order_status = SUCCESS 且发票状态 INVOICE_SUCCESS 时,取发票号码与 PDF 下载地址;
5. 异常:开票失败/卖家未实名→处理后调 order_retry(仅 CONFIRMED / WAIT_PAY 状态可重试);退款后红冲→调 red_apply(仅交易成功订单)。

注意:自然人年累计反向开票额度上限 500 万元,超额将无法开票;订单确认后企业侧不可取消,需自然人在支付宝「反向开票助手」小程序内取消。

请求参数(主表)

order_item_list 商品明细字段

响应参数

请求示例

{
  "tax_no": "913301067046373123",
  "product_id": "2025010031726123",
  "company_clerk_id": "2025011234567890",
  "outer_order_id": "KLREV_20260718_0001",
  "personal_tax_project": "BUSINESS_INCOME",
  "memo": "废铜收购",
  "order_item_list": [{
    "company_item_id": "2025030400152003620000195123",
    "item_num": "2",
    "item_total_amount": "100.00",
    "item_unit": "吨"
  }]
}

响应示例

{
  "code": "10000",
  "msg": "Success",
  "outer_order_id": "KLREV_20260718_0001",
  "order_id": "2025031000152005540029226123",
  "payment_invoice_page_url": "https://u.alipay.cn/_3P00TkBxWtV/2025031000152005540029226123",
  "payment_invoice_page_alipay_url": "alipays://platformapi/startapp?appId=…",
  "payment_invoice_qr_code_url": "https://mobilecodec.alipay.com/show.htm?code=…"
}

outer_order_id 幂等:同一外部订单号重复提交不会重复创建订单。明细行单价/数量/金额三选二必填。

请求参数

响应参数(核心字段)

建议轮询间隔 30 秒以上;开票成功后从 order_invoice_list 取发票号码与 PDF 地址回写贵方台账。

企业配置了「订单需审核」时,自然人确认后需企业审核通过,自然人才能收款开票。

请求参数

审核仅允许修改单价/数量/金额(三选二)与备注,不可更换商品。

三个接口请求参数相同:

• 取消 order_cancel:仅自然人确认前可由企业取消;已开票/已确认收款/已取消/终态订单不可取消;
• 重试 order_retry:开票失败或卖家未实名导致转账失败时,处理完成后重试;仅 CONFIRMED / WAIT_PAY 状态订单可重试;
• 红字申请 red_apply:订单交易成功后需退款冲红时调用;仅 SUCCESS 订单可操作,且同一订单不可重复红冲。

响应 code = 10000 为成功;业务失败时按 sub_code / sub_msg 提示处理。平台层错误码(鉴权/限流/余额)与腾讯系一致,见 错误处理。