> ## Documentation Index
> Fetch the complete documentation index at: https://docs.46w.net/llms.txt
> Use this file to discover all available pages before exploring further.
# 收款二维码问题：上传失败与解析错误处理
> 了解46码支付支持的收款二维码类型，以及上传失败、解析错误、回调测试失败等常见问题的原因分析与解决步骤。
收款二维码是46码支付通道配置中的必填项，系统将通过解析二维码内容来绑定对应的支付宝收款账号。若上传的二维码图片不符合要求，将导致解析失败或回调测试无法通过。本页介绍了平台支持的二维码类型，以及常见二维码错误的排查与修复方法。
## 支持的二维码类型
46码支付目前支持上传以下类型的支付宝收款二维码：
* 个人收款码
* 经营收款码
* 商家码
* 商家经营收款单
请确保您上传的二维码属于上述类型之一，并且该二维码对应的支付宝账号与通道配置中填写的账号信息一致。
## 常见错误及解决方法
**错误原因**
这是最常见的二维码上传问题。当图片中包含过多非二维码内容时（例如背景图案、大量说明文字、装饰性边框、品牌Logo叠加等），系统的解析算法可能无法准确定位二维码区域，从而返回解析失败错误。
**解决方法**
使用任意图片编辑工具（如系统自带的图片查看器、微信图片编辑、美图秀秀等）对图片进行**裁剪**处理：
1. 打开收款码图片。
2. 使用裁剪工具，框选仅包含二维码本身的区域。
3. 去除二维码周围所有的背景、文字说明、装饰边框及Logo内容。
4. 保存裁剪后的图片，重新上传至46码支付平台。
裁剪后的图片中应只有二维码图案本身，四周保留少量白边即可。
如果图片在上传过程中直接失败，请检查以下几点：
**图片格式**
平台建议使用 **JPG** 或 **PNG** 格式的图片文件。若您的图片为其他格式（如 WEBP、BMP、HEIC 等），请先转换为 JPG 或 PNG 后再尝试上传。
**图片大小**
建议上传的图片文件大小**不超过 2MB**。手机截图通常在此范围内，但若您使用的是高分辨率相机拍摄的照片，可能需要先压缩图片大小。
**图片清晰度**
确保图片清晰、对焦准确，不模糊、不过曝。模糊的二维码即便上传成功，也可能在解析时失败。建议在光线充足的环境下重新截图或拍摄收款码。
如果二维码上传未报错，但后续的支付回调测试仍然失败，请排查以下原因：
**二维码与通道账号不匹配**
请确认上传的二维码所属的支付宝账号，与通道配置中填写的**账号ID（PID）和AppID**所对应的支付宝账号完全一致。如果您拥有多个支付宝账号，请特别注意避免将不同账号的二维码与账号参数混用。
**重新下载并裁剪二维码**
若二维码图片已保存较久，建议重新登录支付宝App，重新下载最新版本的收款码图片，裁剪后再次上传，排除因图片版本过旧或文件损坏导致的问题。
使用手机截图保存收款码时，建议在**浅色背景**下截图以提高解析成功率。深色或复杂背景会降低二维码与背景之间的对比度，增加解析失败的概率。
如果您的二维码持续无法解析，请联系46码支付技术支持，并提供您的二维码图片样本。我们的团队将协助您诊断具体原因并给出针对性建议。