submitAttachment需要签名验签
集成商可调用此接口上传万里汇所需的附件。
报文结构
万里汇接口报文结构包括:请求头、请求体、响应体。
请求头
字段名 | 是否必传 | 范例 | 说明 |
Client-Id | 是 |
| |
Signature | 是 |
| |
Content-Type | 是 |
| |
Request-Time | 是 |
| |
Connected-AccountId | 否(有条件要求) |
| 注意此字段 当平台客户操作商户账户时需要传递 |
Access-Token | 有条件要求 |
| 注意此字段 当用 OAUTH 授权时需要传递。参考 applyToken。 |
入参
attachmentId String REQUIRED
附件的 ID。
本字段仅用于标识请求,不用于幂等控制。
更多信息:
- 最大长度:64 字符
attachmentType String REQUIRED
附件类型。
可取值参考:AttachmentType。
attachmentContent String REQUIRED
附件内容。附件最大为7MB,支持格式包括:PNG,JPG,JPEG,PDF,ZIP。
需使用Base64编码。
更多信息:
- 最大长度:9786710 字符
fileName String REQUIRED
上传附件的原始文件名。如: file.pdf
更多信息:
- 最大长度:128 字符
bizType String REQUIRED
持卡人场景类型。
可取值(默认):WF_ADD_WORLD_CARD_HOLDER
出参
result Result REQUIRED
代表接口调用结果
attachmentInfo Object REQUIRED
上传的附件信息。
请求
响应
响应处理
集成商调用接口后,万里汇返回集成商API调用结果。result.resultStatus 字段取值范围为:
| result.resultStatus | 描述 |
|---|---|
| S | API请求成功。 |
| F | API请求失败。 失败原因参见结果码(即 result.resultCode 和 result.resultMessage ) |
| U | API响应结果为UNKNOWN(未知)时,需重试API请求。重试策略: + 重试次数上限:7次 + 重试时间间隔:5分钟、10分钟、20分钟、40分钟、80分钟、160分钟、320分钟 如果问题依旧,请联系万里汇技术支持。 |
result.resultCode 结果码
| 结果码 | 值 | 结果码信息 | 行动建议 |
|---|---|---|---|
| SUCCESS | S | Success | |
| PROCESS_FAIL | F | A general business failure occurred. Do Not retry. | 需要人工介入,联系万里汇技术支持以解决此问题 |
| PARAM_ILLEGAL | F | Illegal parameters exist. For example, a non-numeric input, or an invalid date. | 确认请求正确加签 |
| INVALID_SIGNATURE | F | The signature is invalid. | 确认请求正确加签 |
| REPEAT_REQ_INCONSISTENT | F | Repeated requests are inconsistent. | 重试请求不一致,需保证所有请求参数均相同 |
| UNKNOWN_EXCEPTION | U | API failed due to unknown reason. | 服务器错误,若稍后重试问题依旧,联系万里汇技术支持以解决问题 |
| FILE_SIZE_EXCEED_LIMIT | F | The file size has exceeded the limit. | 文件大小需在允许范围内 |
| CONTRACT_CHECK_FAIL | F | The contract check has failed. | 检查合约状态后重试 |