农银人寿集成

面向农银人寿合作场景，提供权益数据推送与 H5 落地页 URL 获取两类 S2S 接口。 农银侧先通过 card-pool 推送客户权益数据至卡池； 合作方 APP 再携带 SM4 加密 token 调用 h5-url 换取短期 H5 链接。

概述

接口路径前缀：/open/v1/integrations/abclife

接入前提

• 开放平台应用已由实施侧开通「农银人寿」集成能力。
• 调用 h5-url 前，对应客户号与服务编码须已通过card-pool 接口写入第三方卡池；否则将返回 422。
• 合作方与农银侧约定 SM4 密钥及 token 载荷格式，由合作方在调用h5-url 前完成 SM4-ECB 加密与 Base64 编码。
• 厂商侧 SM4 密钥由晓葆平台配置与保管，合作方调用本接口时只需携带开放平台 App 签名，无需在请求中传递密钥。

鉴权说明

标准 S2S 签名。完整算法见鉴权说明。

token 载荷说明

请求体中的 token 为 SM4-ECB 加密后的 JSON 载荷（Base64 编码）。 解密后须包含以下字段：

{
  "customer_no": "<customer_no>",
  "equity_type": "臻享-zx",
  "service_code": "<service_code>"
}

康享（康享-kx）示例：

{
  "customer_no": "<customer_no>",
  "equity_type": "康享-kx",
  "service_code": "<service_code>",
  "policy_no": "<policy_no>"
}

获取 H5 落地页 URL

提交 SM4 加密的业务 token。平台解密并校验载荷后，确认客户号与服务编码 已在第三方卡池中存在，并返回带访问凭证的 H5 落地页完整 URL。 本接口不会写入或更新卡池数据。

请求体（application/json）：

请求示例（占位符，非真实数据）：

POST /open/v1/integrations/abclife/h5-url
X-App-Id: <your_app_id>
X-Timestamp: <unix_seconds>
X-Signature: <signature>
Content-Type: application/json

{
  "token": "<sm4_encrypted_base64_token>"
}

成功响应（200 OK）：

{
  "success": true,
  "code": 0,
  "message": "H5 URL 获取成功",
  "data": {
    "url": "https://<host>/open/h5/abclife/order?token=<access_token>"
  },
  "timestamp": "2026-01-01T00:00:00+08:00"
}

data 字段说明：

推送权益数据至卡池

农银侧主动推送客户权益数据，请求体为 head + body.messageInfo 结构， 支持一次提交多条记录。平台逐条校验并幂等写入第三方卡池（键为应用 ID + customerIDNo + ServiceNo）；重复推送相同键时更新记录。

请求体（application/json）：

head 常见字段（均可选，字段名大小写须与下表一致）：

body.messageInfo[] 单条字段：

请求示例（占位符，非真实数据）：

POST /open/v1/integrations/abclife/card-pool
X-App-Id: <your_app_id>
X-Timestamp: <unix_seconds>
X-Signature: <signature>
Content-Type: application/json

{
  "head": {
    "sysCode": "<sys_code>",
    "tranCode": "<tran_code>",
    "tranDate": "2026-03-03",
    "tranNo": "<tran_no>",
    "tranTime": "09:58:00",
    "txCode": "<tx_code>",
    "txId": "<tx_id>",
    "version": "1.0"
  },
  "body": {
    "messageInfo": [
      {
        "ServiceNo": "<service_no>",
        "RiskCode": "<risk_code>",
        "ContNo": "<cont_no>",
        "CvaliDate": "2026-01-01",
        "customerIDNo": "<customer_id_no>",
        "customerName": "***",
        "IdType": "0",
        "IdNo": "******************",
        "Mobile": "13800138000",
        "SerStartDate": "2026-01-01",
        "SerEndDate": "2026-12-31",
        "EnjoyFlag": "1",
        "Amnt": "100000"
      }
    ]
  }
}

成功响应（200 OK）：

{
  "success": true,
  "code": 0,
  "message": "处理完成",
  "data": {
    "total": 2,
    "success": 1,
    "failed": [
      {
        "index": 1,
        "customerIDNo": "<customer_id_no>",
        "ServiceNo": "<service_no>",
        "error": "卡池写入失败原因"
      }
    ]
  },
  "timestamp": "2026-01-01T00:00:00+08:00"
}

data 字段说明：

错误码