公证服务 · 渠道接入指南

本板块为公证服务对外发布的开放 API 文档,与 订阅+权益 板块并列。

业务定位

公证服务 是 cxh 面向渠道商户开放的单次出证型业务:渠道传入主体信息 + 公证收费,cxh 完成公证履约,回传公证订单号(notaryOrderNo)与公证函(PDF)。

与「订阅+权益」板块的核心差异:

维度	订阅+权益	公证服务
履约模型	周期发权益(N 期月度/日度)	单次出证(一次性)
收费	按周期扣款	单次按公证收费 notaryFeeCent
产物	权益核销 + 兑换	公证订单号 + 公证函 PDF
SPU	走 SPU/SKU/类目	不走,直接传入主体与公证收费

清结算模式

公证下单采用 CXH_DEDUCT(cxh 代扣) 模式:由 cxh 调用支付通道向用户扣款,扣款成功后启动公证出证。用户先通过 订阅业务绑卡流程 在 cxh 完成绑卡,公证下单时传 bindOrderNo。

文档导航

文档	用途
接入流程	公证业务接入流程总览;凭据申请 / 首次调用示例
公证下单	POST /openapi/v1/notary/orders/create
公证查询	POST /openapi/v1/notary/orders/query 查订单状态;响应含公证函下载 URL
错误码	错误码总表,含 451xxx 公证段 + 公证函下载路径错误码段

通用文档

公证服务复用开放 API 的通用约定:

• 快速接入 — 凭据申请、签名鉴权流程
• HTTP 请求 / 响应规范 — URL / 方法 / 头部 / 字段类型 / 重试与超时
• 签名 + 字段加密 — HMAC-SHA256 签名 + AES-256-CBC 字段加密
• 鉴权 — accessToken 获取与使用

注意:公证下单入参中的 PII 字段(身份证 / 手机号 / 统一社会信用代码)采用 AES-CBC 加密,密钥与订阅业务共用 channel aesKey(见 签名 + 字段加密)。

联系方式

参见 联系方式。