资金划拨结果通知
接口说明
资金划拨结果通知
公共报文
| 参数名 | 说明 |
|---|---|
| parentUid | 代理商会员号 |
| uid | 交易会员号 |
| charset | 字符集 固定UTF-8 |
| dataContent | 密文 |
| notifyType | 通知类型,固定值:DQD1-3109-001-01 |
| format | 固定json |
| ncrptnSn | 商户加密证书序列号 |
| signSn | 宝付签名证书序列号 |
| verifyType | 10 国密 11 RSA |
| signStr | 签名串 |
| version | 固定1.0 |
dataContent解密明文
两级嵌套结构
dataContent 包含两级结构:
- 第一层:包含通用头部信息字段
- 第二层:业务内容嵌套在 businessData 字段中
第一层 - 通用头部信息字段
| 字段名 | 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| creditContractType | 授信协议类型 | String(128) | Y | 金融机构标识,如:XW-新网银行等 |
| creditContractId | 授信协议号ID | String(128) | Y | 金融机构分配的成员ID,此处为社统 |
| orderId | 业务流水号 | String(64) | Y | 本次通知的唯一编号 |
| notifyTime | 通知时间 | String | Y | 本次通知回调的时间,格式为yyyy-MM-dd HH:mm:ss |
| businessData | 业务数据 | Object | Y | 业务内容,根据不同金融机构和通知类型而变化,具体内容由各金融机构定义 |
第二层 - 业务内容字段 (businessData)
资金划拨结果通知业务字段
| 字段名 | 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| orderNo | 业务流水号 | String | Y | 银行流水号 |
| transAmount | 交易金额 | Long | Y | 交易金额(分为单位) |
| recordStatus | 处理状态 | String | Y | 处理状态(INIT-初始化, ASSIGNED-已分配到批次, PROCESSED-已处理, FAILED-处理失败) |
| processTime | 处理时间 | String | Y | 处理时间,格式为yyyy-MM-dd HH:mm:ss |
| allocationType | 划拨类型 | String | Y | 划拨类型(TRANSFER-转账还款, WITHDRAWAL-提现) |
| uid | 统一会员号 | String | Y | 统一会员号 |
示例数据
资金划拨结果通知示例
{
"dataContent": {
"creditContractType": "XW",
"creditContractId": "1001",
"orderId": "ORD202301010001",
"notifyTime": "2023-12-01 10:30:45",
"businessData": {
"orderNo": "2023120100000001",
"transAmount": 1000000,
"recordStatus": "SUCCESS",
"processTime": "2023-12-01 10:25:30",
"allocationType": "TRANSFER",
"uid": "10000001"
}
}
}
返回参数
商户处理成功时,须在body中同步返回”OK”字符串,否则会以一定规则进行补发重试
{
"result": "OK"
}