公证服务接入流程

本文为公证业务接入流程总览。HTTP 通用规范 / 签名 / 加密 / 鉴权细节见通用文档。

接入步骤总览

联系 BD 申请凭据 — 公司全称 + 联系人 + 联系方式 + 公证业务场景 + 预估月单量;BD 评估通过后,cxh 下发沙箱 appId / appSecret / aesKey / callbackSecret 四件套(与订阅业务共用)
配置 cxh 侧公证授权(由 BD 协助完成) — 包括公证收费区间等参数
用户先在 cxh 完成绑卡 — 经订阅业务绑卡流程取得 bindOrderNo(公证下单时复用)
沙箱联调 — 按公证下单完成首次成功调用 → 公证函下载
生产凭据申请 — 沙箱联调通过 7 天内,联系 BD 申请生产凭据;沙箱与生产两套独立凭据
生产上线 — 按合同约定的节奏上线

首次成功调用示例

以下示例展示完整调用顺序。所有业务接口(含取 token)都需 5 个签名头:X-CXH-App-Id / X-CXH-Timestamp(Unix 毫秒)/ X-CXH-Nonce(32 hex)/ X-CXH-Request-Id(UUID)/ X-CXH-Signature(HMAC-SHA256 base64);拼装与计算见签名 + 字段加密。

bash

# 1. 取 accessToken(token 接口也需签名)
curl -X POST https://test-api.cxh.me/openapi/v1/auth/token \
  -H "X-CXH-App-Id: test_xxxxxxx" \
  -H "X-CXH-Timestamp: 1714003200123" \
  -H "X-CXH-Nonce: a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4" \
  -H "X-CXH-Request-Id: 7f8a9b1c-2d3e-4f5a-6b7c-8d9e0f1a2b3c" \
  -H "X-CXH-Signature: <HMAC-SHA256 base64>" \
  -H "Content-Type: application/json" \
  -d '{"appId": "test_xxxxxxx", "grantType": "client_credentials"}'

# 2. 公证下单(在 5 个签名头基础上加 Authorization Bearer;PII 字段 AES-CBC 加密见 ../signature-guide.md)
curl -X POST https://test-api.cxh.me/openapi/v1/notary/orders/create \
  -H "Authorization: Bearer <accessToken>" \
  -H "X-CXH-App-Id: test_xxxxxxx" \
  -H "X-CXH-Timestamp: 1714003200456" \
  -H "X-CXH-Nonce: <32 hex 随机>" \
  -H "X-CXH-Request-Id: <UUID>" \
  -H "X-CXH-Signature: <HMAC-SHA256 base64>" \
  -H "Content-Type: application/json" \
  -d '{
    "settlementMode": "CXH_DEDUCT",
    "externalOrderNo": "TEST-202605-001",
    "fileSha256": "<64 hex>",
    "fileName": "合同.pdf",
    "notaryFeeCent": 5000,
    "subjectType": "PERSON",
    "subjectName": "张三",
    "idCardEncrypted": "<AES-CBC ciphertext>",
    "bindOrderNo": "<已完成绑卡的协议单号>"
  }'

# 3. 公证查询(轮询 → status=SUCCESS;签名头同上)
# 4. orders/query 响应含 certificateAccessUrl → 直接 GET 该 URL 下载 PDF(URL 已自带 sig,GET 无需额外签名头)

沙箱与生产差异

公证服务的沙箱与生产接口完全一致(同一套 open API / 签名 / 字段 / 状态机)。沙箱接通后切生产无需修改渠道代码,只换 base URL + 凭据。

项	沙箱	生产
Base URL	`https://test-api.cxh.me`	`https://api.cxh.me`
凭据	沙箱 `appId` / `appSecret` / `aesKey` / `callbackSecret`	生产凭据(独立)
限频	默认宽松	按合同约定
IP 白名单	可申请关闭	强制启用

公证服务接入流程 ​

接入步骤总览 ​

首次成功调用示例 ​

沙箱与生产差异 ​

公证服务接入流程

接入步骤总览

首次成功调用示例

沙箱与生产差异