`/meds/{medId}/evidence-requirements` 接口介绍

接口背景

/meds/{medId}/evidence-requirements 用于查询指定 MED 当前适用的证据材料清单及上传完成情况。

Adopay 根据 medId 确定该 MED 所属的二级商户、行业与商户类型，再匹配对应的材料清单（通用材料 + 行业专属材料，平台型 / PSP 商户另含平台类附加材料）。每个 MED 只适用一份材料清单，合作商无需也不能在请求中另行指定二级商户号、行业或商户类型。

接口请求地址

项目	内容
请求方式	`GET`
请求路径	`/meds/{medId}/evidence-requirements`
Content-Type	`application/json`
接口用途	查询 MED 适用的证据材料清单及完成情况

认证

使用 ES256 请求签名，必须携带 X-Merchant-Id、X-Timestamp、X-Nonce、Digest 和 Authorization。X-Merchant-Id 填写合作商一级商户号，keyId 为密钥版本号，默认 v1。签名值为 DER 编码的 ECDSA 签名经标准 Base64 编码后的结果，具体规则见请求签名。

示例中的时间戳、Nonce、摘要和签名占位符需按每次实际请求生成；签名串包含实际路径及原始 query，分页或筛选条件变化后必须重新签名。

接口请求字段

字段名	位置	类型	是否必填	说明
`medId`	Path	string	是	MED 违规报告唯一标识符（平台案件号，`medc` 前缀 + 数字），最大长度 64 个字符。

请求示例

http

GET /meds/medc2874510938274639021/evidence-requirements HTTP/1.1
Accept: application/json
X-Merchant-Id: <MERCHANT_ID>
X-Timestamp: <UNIX_TIMESTAMP_SECONDS>
X-Nonce: <UNIQUE_NONCE>
Digest: SHA-256=47DEQpj8HBSa+/TImW+5JCeuQeRkm5NMpJWZG3hSuFU=
Authorization: Signature keyId="v1",alg="ES256",headers="(request-target) x-timestamp x-nonce digest",signature="<ES256_SIGNATURE_BASE64>"

接口响应字段

接口使用统一的 status、msg、data 响应结构。证据材料要求位于 data 中，Adopay 内部使用的模板编码和版本不对外返回。

字段名	类型	是否必返	说明
`status`	int	是	响应码
`msg`	string	是	与 `status` 对应
`data`	object	成功必返	MED 的证据材料要求；请求在验签或协议解析阶段失败时可能不返回。
`data.medId`	string	是	MED 唯一标识符。
`data.subMerchantNo`	string	是	该 MED 所属二级商户号。
`data.industry`	string	是	该 MED 所属行业：`ADVERTISING`、`DIGITAL_CONTENT`、`ECOMMERCE`、`EDUCATION`、`FINANCIAL_SERVICES`、`GAMING`、`LOGISTICS`、`OTHER`、`PROFESSIONAL_SERVICES` 或 `SAAS`。
`data.complete`	boolean	是	当前 MED 的所有必填（`REQUIRED`）材料是否均已上传对应文件；`CONDITIONAL` 材料不参与该统计。
`data.requirements`	array	是	该 MED 当前适用的证据材料要求（通用材料 + 行业专属材料，平台型 / PSP 商户另含平台类附加材料）。
`data.requirements[].evidenceType`	string	是	证据材料类型，取值见下方“行业与证据材料”章节。
`data.requirements[].requirementLevel`	string	是	要求级别：`REQUIRED`、`CONDITIONAL`、`RECOMMENDED` 或 `OPTIONAL`。
`data.requirements[].requirementDescription`	string	是	要求说明，如“必填”“建议”或“如发生退款则应提供,可上传截图”。
`data.requirements[].required`	boolean	是	该材料本次是否必须提交：`requirementLevel` 为 `REQUIRED` 时为 `true`；`CONDITIONAL` 仅提示不强制，恒为 `false`。
`data.requirements[].uploadedFileCount`	int	是	当前已上传且归类到该材料类型的有效文件数量。

响应示例

json

{
  "status": 200,
  "msg": "sucesso",
  "data": {
    "medId": "medc2874510938274639021",
    "subMerchantNo": "24922653000123",
    "industry": "GAMING",
    "complete": false,
    "requirements": [
      {
        "evidenceType": "TRANSACTION_AUTHENTICITY_STATEMENT",
        "requirementLevel": "REQUIRED",
        "requirementDescription": "必填",
        "required": true,
        "uploadedFileCount": 1
      },
      {
        "evidenceType": "MERCHANT_ORDER_RECORD",
        "requirementLevel": "REQUIRED",
        "requirementDescription": "必填",
        "required": true,
        "uploadedFileCount": 0
      }
    ]
  }
}

行业与证据材料

材料清单由通用材料与行业专属材料组成；平台型（platform）/ PSP（psp）商户另需提供平台类附加材料（见下文）。材料按平台配置的顺序返回，各表中的“要求”与接口返回的 requirementLevel、requirementDescription 对应。

要求级别

`requirementLevel`	说明	是否影响 `data.complete`
`REQUIRED`	必填材料。	是
`CONDITIONAL`	满足 `requirementDescription` 描述的场景时建议提交；平台无法自动判定触发条件，仅提示不强制。	否
`RECOMMENDED`	建议提交，有助于Adopay 审核。	否
`OPTIONAL`	可选材料。	否

通用材料（所有商户）

`evidenceType`	材料	要求
`TRANSACTION_AUTHENTICITY_STATEMENT`	交易真实性说明	必填
`MERCHANT_ORDER_RECORD`	商户订单/业务订单	必填
`CUSTOMER_IDENTIFIER`	用户/客户标识	必填
`PRODUCT_SERVICE_CONTENT`	商品或服务内容	必填
`DELIVERY_PROOF`	履约/服务提供证明	必填
`OTHERS`	其他证据材料	可选；材料无法归入上述分类时使用

广告（ADVERTISING）、教育（EDUCATION）、金融服务（FINANCIAL_SERVICES）、物流（LOGISTICS）、其他（OTHER）行业仅需上述通用材料。

实物商品 / 电商（PHYSICAL GOODS / ECOMMERCE）

行业专属材料：

`evidenceType`	材料	要求
`FULFILLMENT_RECORD`	发货记录	必填
`LOGISTICS_TRACKING`	物流单号/物流轨迹	必填（可上传截图）
`DELIVERY_CONFIRMATION`	签收证明	建议
`USER_COMMUNICATION_RECORD`	用户沟通记录	建议
`RETURN_REFUND_RECORD`	退货/退款记录	条件必填：如发生退货/退款则应提供（可上传截图）

数字商品 / 数字内容（DIGITAL GOODS）

行业专属材料：

`evidenceType`	材料	要求
`USER_ACCOUNT_RECORD`	用户账号（Subscription Account）	必填
`SERVICE_ACTIVATION_RECORD`	服务开通记录	必填
`CONTENT_USAGE_RECORD`	内容观看/使用记录	必填
`LOGIN_IP_DEVICE_RECORD`	登录记录/IP/Device	建议
`SUBSCRIPTION_PERIOD`	订阅起止时间	建议
`USER_COMMUNICATION_RECORD`	用户沟通记录	建议
`CANCELLATION_REFUND_RECORD`	取消订阅/退款记录	条件必填：如发生取消订阅/退款则应提供（可上传截图）
`AUTO_RENEWAL_AUTHORIZATION`	自动续费授权记录	条件必填：自动续费争议必填（可上传截图）

游戏（GAMING）

行业专属材料：

`evidenceType`	材料	要求
`USER_ACCOUNT_RECORD`	用户 ID / 游戏账号	必填
`TOP_UP_PURCHASE_RECORD`	充值/购买记录	必填
`VIRTUAL_ASSET_DELIVERY_RECORD`	虚拟币、道具或权益到账记录	必填
`CONSUMPTION_USAGE_RECORD`	消费/使用记录	建议
`LOGIN_IP_DEVICE_RECORD`	登录记录/IP/Device	建议；未经授权/欺诈类争议必填
`USER_TRANSACTION_HISTORY`	用户历史交易记录	建议

当争议类型（originSituationType）为 SCAM_FRAUD、UNAUTHORIZED_TRANSACTION 或 FRAUDULENT_ACCESS_AND_AUTHORIZATION 时，LOGIN_IP_DEVICE_RECORD 由“建议”升级为必填。

服务类（SERVICES）

行业专属材料：

`evidenceType`	材料	要求
`INVOICE`	Invoice	必填
`CONTRACT_ORDER_AGREEMENT`	服务合同/Order Agreement	必填
`SERVICE_DELIVERY_RECORD`	服务交付记录	必填
`SERVICE_ACCEPTANCE_RECORD`	服务验收记录	建议
`COMMUNICATION_RECORD`	项目沟通记录	建议
`PARTNERSHIP_TRANSACTION_HISTORY`	历史合作记录	建议
`REFUND_REVERSAL_RECORD`	退款/冲销记录	条件必填：如发生退款/冲销则应提供（可上传截图）

SaaS / 订阅服务（SAAS / SUBSCRIPTION）

行业专属材料：

`evidenceType`	材料	要求
`USER_COMPANY_ACCOUNT`	用户 ID / 企业账号	必填
`SERVICE_ACTIVATION_RECORD`	服务开通记录	必填
`LOGIN_USAGE_RECORD`	登录/使用记录	必填
`FEATURE_USAGE_LOG`	功能使用日志	建议
`IP_DEVICE_RECORD`	IP/Device	建议
`PRODUCT_PLAN_INFORMATION`	套餐/Subscription Plan	建议
`CANCELLATION_REFUND_RECORD`	取消/退款记录	条件必填：如发生取消/退款则应提供（可上传截图）

平台 / PSP（PLATFORM / PSP）

除通用材料与所在行业的专属材料外，平台型（platform）与 PSP（psp）商户还需提供以下材料：

`evidenceType`	材料	要求
`ACTUAL_MERCHANT_INFO`	实际商户信息/Merchant ID	必填
`PLATFORM_TRANSACTION_RECORD`	平台交易记录	必填
`DOWNSTREAM_MERCHANT_ORDER`	下游商户订单	必填
`SETTLEMENT_SPLIT_RECORD`	商户结算/分账记录	建议
`USER_COMMUNICATION_RECORD`	用户与商户沟通记录	建议
`DOWNSTREAM_TRANSACTION_HISTORY`	下游商户历史交易记录	建议
`REFUND_RECORD`	退款记录	条件必填：如发生退款则应提供（可上传截图）
`OTHERS`	其他证据材料	可选；材料无法归入上述分类时使用

USER_COMMUNICATION_RECORD 仅对行业专属材料中未包含用户沟通记录的行业返回，不会重复列出。

材料清单匹配规则

Adopay 根据 medId 确定该 MED 所属的行业与商户类型；每个 MED 只适用一份材料清单，商户无需也不能在请求中另行指定。
材料清单 = 通用材料 + 所在行业的专属材料；平台型与 PSP 商户另加平台类附加材料。游戏行业还会结合争议类型调整个别材料的要求级别（见上文「游戏」）。
清单内容与展示顺序由平台配置维护，可能随规则调整，以接口实际返回为准；模板编码、模板版本及具体匹配过程属于 Adopay 内部信息，不在接口响应中返回。

业务规则

合作商不能通过请求参数覆盖该 MED 的二级商户或行业。
uploadedFileCount 仅统计通过文件格式校验且已归类为对应 evidenceType 的文件。
无法明确归类的补充材料可使用 OTHERS；该类型为可选，不影响 data.complete。
complete 仅表示所有必填（REQUIRED）材料是否均已上传对应文件；CONDITIONAL、RECOMMENDED 与 OPTIONAL 材料不参与该统计。材料完整性仅对 REJECTED（驳回）裁决强制，提交 ACCEPTED（接受）裁决时无需上传证据文件。提交分析时仍会执行 MED 状态、权限、并发及其他业务校验。
材料上传与提交须在举证截止时间（dueTime）前完成，超期后上传与提交接口均会拒绝。
最终提交要求以服务端在调用提交分析接口时的校验结果为准。

返回 MED API 总览

账户

商户

收款

付款

PixKey管理

对账文件

MED

Webhook 事件

`/meds/{medId}/evidence-requirements` 接口介绍

接口背景

接口请求地址

认证

接口请求字段

请求示例

接口响应字段

响应示例

行业与证据材料

要求级别

通用材料（所有商户）

实物商品 / 电商（PHYSICAL GOODS / ECOMMERCE）

数字商品 / 数字内容（DIGITAL GOODS）

游戏（GAMING）

服务类（SERVICES）

SaaS / 订阅服务（SAAS / SUBSCRIPTION）

平台 / PSP（PLATFORM / PSP）

材料清单匹配规则

业务规则

/meds/{medId}/evidence-requirements 接口介绍 ​

接口背景 ​

接口请求地址 ​

认证 ​

接口请求字段 ​

请求示例 ​

接口响应字段 ​

响应示例 ​

行业与证据材料 ​

要求级别 ​

通用材料（所有商户） ​

实物商品 / 电商（PHYSICAL GOODS / ECOMMERCE） ​

数字商品 / 数字内容（DIGITAL GOODS） ​

游戏（GAMING） ​

服务类（SERVICES） ​

SaaS / 订阅服务（SAAS / SUBSCRIPTION） ​

平台 / PSP（PLATFORM / PSP） ​

材料清单匹配规则 ​

业务规则 ​

`/meds/{medId}/evidence-requirements` 接口介绍

接口背景

接口请求地址

认证

接口请求字段

请求示例

接口响应字段

响应示例

行业与证据材料

要求级别

通用材料（所有商户）

实物商品 / 电商（PHYSICAL GOODS / ECOMMERCE）

数字商品 / 数字内容（DIGITAL GOODS）

游戏（GAMING）

服务类（SERVICES）

SaaS / 订阅服务（SAAS / SUBSCRIPTION）

平台 / PSP（PLATFORM / PSP）

材料清单匹配规则

业务规则