证据标签

2026-11-02 15:53

本文档用于说明商户在智能抗辩场景中可提交的证据标签（即 evidenceTag 参数的取值），以及不同证据标签包含的参数。商户应根据争议原因、商品类型及所属 MCC 选择合适的证据标签提交证据材料。这些枚举值在以下文档的中使用：

supplyEvidence 接口
notifyDefenseStrategySuggestion 接口

通用证据

ORDER_INFORMATION

该标签用于提交争议交易对应的原始订单信息，包括商户订单号、商品描述、价格、数量、订单凭证及收件人信息等，适用于大多数争议场景。

参数	参数类型	最大长度	是否必需	描述
merchantOrderNo	String	64	M	商户订单号。
productDescription	String	512	O	商品描述。注意：当拒付原因属于商品/服务与描述不符类时必传。
productUnitPrice	String	32	O	商品单价，数字字符串。
quantity	String	16	O	数量，正整数字符串。
originalOrderReceiptFile	EvidenceFile	不涉及	O	原始订单凭证和订单收据。
receiverName	String	128	O	收件人姓名。
receiverEmailAddress	String	256	O	收件人邮箱。
receiverContactNumber	String	32	O	收件人联系电话。

CUSTOMER_COMMUNICATIONS

该标签用于提交买卖双方的沟通记录，可通过文字或截图形式提供，用于证明交易沟通过程、服务承诺、客户确认或争议处理过程。

注意：以下两个参数至少传入一个，均为空时系统将返回 EVIDENCE_CONTENT_INVALID。

参数	参数类型	最大长度	是否必需	描述
customerCommunications	String	4096	O	文字形式的沟通记录。
customerCommunicationsFile	EvidenceFile	不涉及	O	截图形式的沟通记录。

USER_HISTORY_UNDISPUTED_TRANSACTION

该标签用于提交买家的历史正常交易记录，以证明买家与商户之间曾存在成功且无争议的交易关系。支持提交多条记录，数据结构为 List<Map>，详见 supplyEvidence 接口示例代码。

参数	参数类型	最大长度	是否必需	描述
transactionDate	Datetime	32	M	交易日期。
transactionAmount	String	32	M	交易金额，数字字符串。
transactionCurrency	String	3	M	币种。该笔历史交易实际发生币种，不要求与当前争议交易币种一致。
arn	String	64	O	清算号。
orderDescription	String	512	O	订单描述。
paymentAuthMode	String	32	O	授权模式。
ipAddress	String	64	O	下单 IP，IPv4/IPv6。
supplementProof	String	2048	O	补充证据（文字）。
supplementProofFile	EvidenceFile	不涉及	O	补充证据（文件）。

REFUND_INFORMATION

该标签用于提交争议订单相关的退款信息，包括退款方式、退款金额及退款完成时间，用于证明商户已进行退款或补偿处理。对于商户未按原支付路径退款的场景（例如以代金券、优惠券等方式替代退款），需由商户就实际退款情况提供举证材料。

参数	参数类型	最大长度	是否必需	描述
merchantOrderNo	String	64	M	商户订单号。
refundMethod	String	32	O	退款方式，如原路退回或代金券。
refundedAmount	String	32	O	退款金额，数字字符串。
refundFinishedTime	Datetime	32	O	退款完成时间。

PICTURE_OF_DISPATCHED_ITEM

该标签用于提交已寄送商品的照片，用于证明商户实际发出了符合订单内容的商品。

参数	参数类型	最大长度	是否必需	描述
pictureOfDispatchedItemFile	EvidenceFile	不涉及	M	寄送商品的照片。

MERCHANT_COMMENTS

该标签用于提交商家针对该争议交易的补充说明、评论或附言。

注意：以下两个参数至少传入一个，均为空时系统将返回 EVIDENCE_CONTENT_INVALID。

参数	参数类型	最大长度	是否必需	描述
merchantComments	String	2048	O	商家评论/附言。
merchantCommentsFile	EvidenceFile	不涉及	O	商家评论/附言。

MARKETING_MATERIALS_AND_LISTINGS

该标签用于提交与商品宣传、展示或销售陈述相关的证据材料。

注意：以下两个参数至少传入一个，均为空时系统将返回 EVIDENCE_CONTENT_INVALID。

参数	参数类型	最大长度	是否必需	描述
marketingMaterialsAndListings	String	2048	O	商品宣传照片和陈述。
marketingMaterialsAndListingsFile	EvidenceFile	不涉及	O	商品宣传照片和陈述。

政策与陈述类

该标签用于提交商户政策、平台规则、认证记录、商品宣传材料、商家说明及服务使用记录等证据。

注意：

文本参数与文件参数至少需传入一个，均为空时系统将返回 EVIDENCE_CONTENT_INVALID。
RETURN_AND_REFUND_POLICY、CANCELLATION_POLICY、SUBSCRIPTION_POLICY、PAYMENT_POLICY 属商户级固定证据：一次提交后按 parentMerchantNo 留存并自动并入该商户后续全部案件，无需逐案重复提交；同标签重复提交为覆盖。合并后总量上限 32KB（UTF-8 字节），超限返回 FIXED_EVIDENCE_SIZE_EXCEED 且整笔调用失败、留存内容不变更。

evidenceTag	文本参数（String，≤ 2048）	文件参数（EvidenceFile）	说明
RETURN_AND_REFUND_POLICY	returnAndRefundPolicy	returnAndRefundPolicyFile	退货退款政策。
CANCELLATION_POLICY	cancellationPolicy	cancellationPolicyFile	取消政策。
SUBSCRIPTION_POLICY	subscriptionPolicy	subscriptionPolicyFile	续费政策。
PAYMENT_POLICY	paymentPolicy	paymentPolicyFile	平台支付规则。
BOOKING_CONFIRMATION_TERMS	bookingConfirmationTerms	bookingConfirmationTermsFile	预定确认条款。
OFFLINE_SIGNED_AGREEMENT	offlineSignedAgreement	offlineSignedAgreementFile	线下签署的协议。
INSTALLMENT_BILLING_AGREEMENT	installmentBillingAgreement	installmentBillingAgreementFile	分期付款协议。

实物类证据

LOGISTIC_INFORMATION

该标签用于提交实物商品的物流配送信息，包括物流单号、收件地址、物流链接、寄送证明及物流截图，用于证明商品已发货或已配送。

参数	参数类型	最大长度	是否必需	描述
trackingNumber	String	64	M	物流单号。
postCode	String	16	O	邮政编码。
shippingAddress	String	512	O	收件地址。
trackingUrl	String	512	O	物流查询链接。
proofOfShipmentFile	EvidenceFile	不涉及	O	寄送证明。
logisticScreenshotFile	EvidenceFile	不涉及	O	物流截图。

CERTIFICATION_RECORDS

该标签用于提交与实物商品认证、鉴定或验真相关的记录材料。

注意：以下两个参数至少传入一个，均为空时系统将返回 EVIDENCE_CONTENT_INVALID。

参数	参数类型	最大长度	是否必需	描述
certificationRecords	String	2048	O	认证记录
certificationRecordsFile	EvidenceFile	不涉及	O	认证记录文件。

服务与虚拟类证据

PROOF_OF_DIGITAL_ACCESS

该标签用于提交虚拟商品或电子商品的送达凭证，尤其适用于充值、数字内容或电子服务类交易，用于证明买家已获得对应数字商品或服务访问权限。

参数	参数类型	最大长度	是否必需	描述
merchantOrderNo	String	64	M	商户订单号。
userRechargeAccountNumber	String	128	M	买家充值账户。虚拟商品未收到类原因码的核心举证。
digitalProductCompletionFile	EvidenceFile	不涉及	O	订单完成凭证。

PROOF_OF_SERVICE_COMPLETION

该标签用于提交服务已完成的证明材料，适用于服务类交易场景，用于证明商户已按约定完成服务交付。

注意：以下两个参数至少传入一个，均为空时系统将返回 EVIDENCE_CONTENT_INVALID。

参数	参数类型	最大长度	是否必需	描述
merchantOrderNo	String	64	M	商户订单号。
serviceCompletionFile	EvidenceFile	不涉及	O	服务完成证明。

USAGE_RECORDS_OF_RECURRING_SERVICE

该标签用于提交用户历史续费服务的使用记录，证明用户曾使用或持续使用相关订阅/续费服务。

注意：以下两个参数至少传入一个，均为空时系统将返回 EVIDENCE_CONTENT_INVALID。

字段名称	类型	最大长度	必填	说明
usageRecordsOfRecurringService	String	2048	O	历史续费服务使用记录。
usageRecordsOfRecurringServiceFile	EvidenceFile	不涉及	O	历史续费服务使用记录文件。

机酒类

该类标签适用于机票、酒店及旅行预订相关争议，用于提交订单摘要、行程信息、酒店预订信息及酒店账单信息等行业专用证据。其中 FLIGHT_ORDER_SUMMARY和ITINERARY_INFORMATION 类型支持提交多条记录，数据结构为 List<Map>，详见 supplyEvidence 接口示例代码。

evidenceTag	参数	参数类型	最大长度	是否必需	描述
FLIGHT_ORDER_SUMMARY	orderNumber	String	64	M	订单号。
	bookingTime	Datetime	32	O	预订时间。
	airRoute	String	128	O	航线。
	numberOfPassenger	String	8	O	乘客数量。
	passengerName	String	128	O	乘客姓名。
	bookingReferenceNumber	String	64	O	预订参考号。
	ticketNumber	String	64	O	电子客票号。
	orderStatus	String	32	O	订单状态。
	orderAmount	String	32	O	订单金额。
	totalPaymentAmount	String	32	O	总支付金额。
ITINERARY_INFORMATION	orderNumber	String	64	M	订单号。
	flightRoute	String	128	O	航线。
	flightNo	String	16	O	航班号。
	cabinClass	String	32	O	舱位。
	departureTime	Datetime	32	O	起飞时间。
	arrivalTime	Datetime	32	O	降落时间。
	ticketStatus	String	32	O	机票状态。
	baggage	String	64	O	行李额度。
	supplementProof	String	2048	O	补充证据（文字）。
	supplementProofFile	EvidenceFile	不涉及	O	补充证据（文件）。
HOTEL_RESERVATION_INFORMATION	reservationConfirmationNumber	String	64	M	预订确认号。
	hotelName	String	256	O	酒店名称。
	hotelAddress	String	512	O	酒店地址。
	orderStatus	String	32	O	订单状态。
	checkInDate	Datetime	32	O	入住日期。
	checkOutDate	Datetime	32	O	退房日期。
	numberOfGuest	String	8	O	入住人数量。
	guestName	String	128	O	入住人姓名。
	prePaymentFees	String	32	O	预付金。
	supplementProof	String	2048	O	补充证据（文字）。
	supplementProofFile	EvidenceFile	不涉及	O	补充证据（文件）。
HOTEL_BILL_INFORMATION	accommodationFeePerNight	String	32	M	每晚住宿费。
	numberOfNight	String	8	O	入住晚数。
	additionalServiceCharge	String	32	O	额外服务费。
	cityTax	String	32	O	城市税或旅游税。
	checkoutPayment	String	32	O	退房结算金额。
	supplementProof	String	2048	O	补充证据（文字）。
	supplementProofFile	EvidenceFile	不涉及	O	补充证据（文件）。

商家补充证据

UNCATEGORIZED

该标签适用于提交无法归入其他证据类型的补充材料，支持文字说明及最多 5 个文件上传。所有商户均可使用该标签，用于补充额外的争议陈述、相关图片或其他辅助性证据。

注意：以下两个参数至少传入一个，均为空时系统将返回 EVIDENCE_CONTENT_INVALID。

参数	参数类型	最大长度	是否必需	描述
supplementProof	String	4096	O	未分类文字证据。
supplementProofFileList	Array	最多 5 个元素	O	未分类文件证据列表，用于提交无法归入其他 23 个证据标签的文件类补充材料。该参数为数组类型，最多支持 5 个文件元素。该参数允许提交多个文件的字段，适用于材料形态不固定的场景，例如多张截图加一份 PDF。若数组元素超过 5 个，将返回 CAPACITY_EXCEEDED，且整笔请求会被拒绝，服务端不会截断保存。注意：同一标签重复提交会覆盖原内容，多份文件应在同一次调用中提交，拆分多次提交不会累积，后一次提交会覆盖前一次。