上传支付凭证接口

商户为买单上传支付凭证。适用于买单场景，商户付款后上传凭证供交易员确认。

端点

接口	路径
真实接口	POST /merchant/uploadPaymentProof
测试接口	POST /test/uploadPaymentProof

适用场景

仅适用于买入订单（order_type=1），商户付款后上传凭证。

请求参数

参数名	类型	必填	说明
api_key	string	是	商户 API 密钥
timestamp	int	是	当前时间戳（允许 5 分钟误差）
nonce	string	是	随机字符串，建议 16 位
signature	string	是	请求签名
order_no	string	是	订单编号
proof_image_url	string	是	支付凭证图片 URL，必须是可访问的图片链接

请求示例

{
    "api_key": "your_api_key",
    "timestamp": 1699065600,
    "nonce": "abc123def456",
    "signature": "generated_signature_here",
    "order_no": "ORD202511041234567890",
    "proof_image_url": "https://example.com/payment_proof.jpg"
}

响应参数

参数名	类型	说明
order_no	string	订单编号
payment_proof	string	支付凭证图片 URL
payment_proof_url	string	支付凭证完整 URL（同 payment_proof）
upload_time	string	上传时间，格式：Y-m-d H:i:s

响应示例

{
    "code": 1,
    "msg": "支付凭证上传成功",
    "data": {
        "order_no": "ORD202511041234567890",
        "payment_proof": "https://example.com/payment_proof.jpg",
        "payment_proof_url": "https://example.com/payment_proof.jpg",
        "upload_time": "2025-11-04 14:30:25"
    }
}

接口说明

• 订单状态要求： 只有状态为 pending 的买入订单可以上传支付凭证
• 图片要求： 支付凭证必须是可访问的图片 URL，支持 jpg、jpeg、png、gif、webp 格式
• URL 验证： 系统会验证图片 URL 的可访问性和格式
• 状态变更： 上传成功后，订单状态变更为 paid（已支付 / 已上传凭证）
• 通知机制： 上传成功后会通知交易员进行凭证确认

重要提示

• 确保图片 URL 可正常访问，否则上传会失败
• 只能为买入订单上传支付凭证
• 订单必须已匹配交易员才能上传凭证