3.14 客诉接口

URL参数名

说明

类型

取值

可空

备注

WOID

工单编号

C(1,40)

非空

WOTP

工单类型

C(1)

5-银行投诉，A-客诉持卡人交易查询投诉

WOSTATUS

工单状态

C(1)

6-待回复

非空

PRIORITY

优先级

C(1)

1-低,2-正常,3-高,4-紧急,5-一般

非空

MERCHANT_ID

商户号

C(15)

非空

MERCHANT_NAME

商户名称

C(1,128)

非空

URLENCODE，UTF-8编码

WODESC

投诉事由

C(1，1000)

非空

URLENCODE，UTF-8编码

COMPDT

投诉日期

C(10)

YYYY-MM-DD

非空

COMPTRXTIME

投诉交易时间

C(19)

YYYY-MM-DD HH:mm:ss

非空

URLENCODE，UTF-8编码

COMPAMOUNT

投诉金额

N(1,12)

非空

URLENCODE，UTF-8编码

CARDNO

银行卡号

C(60)

AES加密

非空

BANKNAME

所属银行名称

C(1,128)

URLENCODE，UTF-8编码

COMPLAINTPHONE

联系电话

C(11)

AES加密

非空

COMPNAME

投诉人姓名

C(3,60)

非空

URLENCODE，UTF-8编码

WOGENERATETIME

工单生成时间

C(14)

YYYY-MM-DD HH24:mm:ss

非空

URLENCODE，UTF-8编码

SIGN

签名

签名原始内容为
WOID|MERCHANT_ID|CARDNO| COMPLAINTPHONEA

非空

CARDNO为加密字符串

COMPLAINTPHONE为加密字符串

接口

字段ID

字段名称

类型

取值

限制

备注

INFO

TRX_CODE

交易代码

C(1, 20)

350002

M

VERSION

版本

C(2)

04

M

DATA_TYPE

数据格式

N(1)

2：xml格式

M

LEVEL

处理级别

N(1)

0-9 0优先级最低，默认为5

M

MERCHANT_ID

商户代码

C(15)

商户ID

M

USER_NAME

用户名

C(1,20)

M

USER_PASS

用户密码

M

REQ_SN

交易批次号

C(40)

M

不重复流水

SIGNED_MSG

签名信息

C

M

CPWOREPLY

WOID

工单编号

C(1,40)

M

WOTP

工单类型

C(1)

5-银行投诉

A-客诉持卡人交易查询投诉

M

CONTENT

回复内容

C(1，1000)

M

SUBMIT_TIME

提交时间

C(14)

yyyyMMddHHmmss

M

COMPTP

投诉类型

C(1，60)

"银行投诉"必填

字典：交易纠纷（信贷类）、交易纠纷（非信贷类）、涉赌涉诈、终端管理及押金、小微商户注销、历史违规平台、非我司交易、其他（请填写具体情况）

C

COMPTPISSUES

投诉类型具体情况

C(1，60)

compTp为“其他”时必填

C

ISCONTACTOPTION

是否已取得联系

C(1)

“银行投诉”必填

字典：是、否

C

CONTACTTIME1

联系时间1

C(19)

“银行投诉”必填

格式：YYYY-MM-DD HH24:mm:ss

C

CONTACTTIME2

联系时间2

C(19)

当ISCONTACTOPTION为否时必填

格式：YYYY-MM-DD HH24:mm:ss

C

CONTACTTIME3

联系时间3

C(19)

当ISCONTACTOPTION为否时必填

格式：YYYY-MM-DD HH24:mm:ss

C

COMMINFO

沟通情况

C(1，1000)

“银行投诉”必填

多行文本框

C

ISREFUNDED

是否已退款

C(1)

“银行投诉”必填

字典：是、否

C

ISACCEPTOPTION

投诉人是否接受处理结果

C(1)

“银行投诉”必填

字典：是、否

C

RESULTINFO

处理结果

C(1，1000)

“银行投诉”必填

多行文本框

C

CONTRACTPROVINFO

联系记录凭证提供情况说明

C(1，1000)

“银行投诉”场景下contractProvInfo和contractProvAttachments二选一不为空

多行文本框

C

CPWOREPLY/ CONTRACTPROVATTCHS/ CPWOATTCH

FILEBIZTP

文件业务类型

101-银行投诉-联系记录凭证

102-银行投诉-合作协议（需有双方盖章及签订日期）

103-银行投诉-委托扣款授权书

104-银行投诉-绑卡签约证明

105-银行投诉-短信验证记录

M

FILEPATH

文件路径

SFTP 绝对路径，必须指向已上传成功的文件。例如：/sftpdata/complaint/reply/ WO202605270001/WO202605270001_101_8f3a9c2d.png

M

FILENAME

原始文件名称

业务方上传前的原始文件名，用于页面展示和问题排查。例如：联系记录截图.png

M

FILESIZE

文件大小

文件字节数，单位 byte。风控系统读取 SFTP 文件后需与该值比对。

M

CPWOREPLY/ CONTRACTPROVATTCHS/ CPWOATTCH

FILEBIZTP

文件业务类型

101-银行投诉-联系记录凭证

102-银行投诉-合作协议（需有双方盖章及签订日期）

103-银行投诉-委托扣款授权书

104-银行投诉-绑卡签约证明

105-银行投诉-短信验证记录

M

FILEPATH

文件路径

SFTP 绝对路径，必须指向已上传成功的文件。例如：/sftpdata/complaint/reply/ WO202605270001/WO202605270001_101_8f3a9c2d.png

M

FILENAME

原始文件名称

业务方上传前的原始文件名，用于页面展示和问题排查。例如：联系记录截图.png

M

FILESIZE

文件大小

文件字节数，单位 byte。风控系统读取 SFTP 文件后需与该值比对。

M

接口

字段ID

字段名称

类型

取值

限制

备注

INFO

TRX_CODE

交易代码

C(1, 20)

350002

M

VERSION

版本

C(2)

03

M

DATA_TYPE

数据格式

N(1)

2：xml格式

M

REQ_SN

交易批次号

C(40)

M

RET_CODE

返回代码

C(4)

参考3.4

M

ERR_MSG

错误信息

C(1,256)

C

SIGNED_MSG

签名信息

C

M

CPWOREPLYRSP

RET_CODE

返回码

C(4)

C

ERR_MSG

错误文本

C(1,256)

C

项目

规范

目录

/rootDir/complaint/reply，其中/rootDir为实际根路径，商户提供，统一运营平台配置

业务目录

/rootDir/complaint/reply/{woId} ，其中/rootDir为实际根路径，商户提供，统一运营平台配置

文件命名

{woId}_{fileBizTp}_{uuid}.{ext}

文件扩展名必须与实际文件类型一致，支持类型：jpg、png、pdf、docx、xlsx。

示例

/rootDir/complaint/reply/WO202605270001/WO202605270001_101_8f3a9c2d.png

/rootDir/complaint/reply/WO202605270001/WO202605270001_102_b27a2a1b.pdf

/rootDir/complaint/reply/WO202605270001/WO202605270001_105_13ab9f00.xlsx

目录创建

由上传方根据工单编号创建目录；

步骤

处理方

说明

1

业务方

按目录规范将附件上传至 SFTP。

2

业务方

读取上传完成后的文件，计算 fileSize

3

业务方

调用 /arsapi/custom/push/orderReply，在 contractProvAttachments 或 supportAttachments 中上送 filePath、fileName、fileSize等信息。

4

风控系统

根据 filePath 从 SFTP 读取文件，校验文件是否存在、路径是否合法、文件类型是否合法、文件大小是否一致。

5

风控系统

校验通过后，保存附件与 woId、fileBizTp 的关联关系；校验失败则返回对应错误码。

校验项

规则

失败建议应答码

路径合法性

filePath 必须位于约定根目录/rootDir/complaint/reply/ 下，且路径中不得包含 ../ 等目录穿越字符。

1012 文件路径非法

工单一致性

filePath 路径或文件名中包含 woId必须与报文 woId 一致。

1012 文件路径非法

文件存在性

SFTP 指定路径文件必须存在且可读取。

1011 文件不存在

文件类型

文件扩展名必须为 jpg、png、pdf、docx、xlsx。

1009 文件类型不支持

文件大小

单文件不超过 10MB；实际文件大小必须与 fileSize 一致。

1010 上传文件过大 / 1014 文件大小不一致

业务类型

contractProvAttachments 只允许 fileBizTp=101；supportAttachments 只允许 fileBizTp=102、103、104、105。

1008 文件业务类型异常