统一收单交易创建接口 - 支付宝开放平台 https://opendocs.alipay.com/apis/api_1/alipay.trade.create
公共响应参数
| 参数 | 类型 | 是否必填 | 最大长度 | 描述 | 示例值 |
|---|---|---|---|---|---|
| code | String | 是 | - | 网关返回码,详见文档 | 40004 |
| msg | String | 是 | - | 网关返回码描述,详见文档 | Business Failed |
| sub_code | String | 否 | - | 业务返回码，参见具体的API接口文档 | ACQ.TRADE_HAS_SUCCESS |
| sub_msg | String | 否 | - | 业务返回码描述，参见具体的API接口文档 | 交易已被支付 |
| sign | String | 是 | - | 签名,详见文档 | DZXh8eeTuAHoYE3w1J+POiPhfDxOYBfUNn1lkeT/V7P4zJdyojWEa6IZs6Hz0yDW5Cp/viufUb5I0/V5WENS3OYR8zRedqo6D+fUTdLHdc+EFyCkiQhBxIzgngPdPdfp1PIS7BdhhzrsZHbRqb7o4k3Dxc+AAnFauu4V6Zdwczo= |
公共错误码 - 支付宝开放平台 https://opendocs.alipay.com/open/common/105806
公共错误码
公共错误码
更新时间：2020-02-06 22:17:51
支付宝网关会对开发者的接口非业务调用错误做统一处理，返回码如下：
API 公共错误码
| code（返回码） | msg（返回码描述） | sub_code（明细返回码） | sub_msg（明细返回码描述） | 解决方案 |
| 10000 | 接口调用成功，调用结果请参考具体的 API 文档所对应的业务返回参数。 | |||
| 20000 | 服务不可用 | isp.unknow-error | 服务暂不可用（业务系统不可用） | 稍后重试 |
| aop.unknow-error | 服务暂不可用（网关自身的未知错误） | 稍后重试 | ||
| 20001 | 授权权限不足 | aop.invalid-auth-token | 无效的访问令牌 | 请刷新授权令牌或重新授权获取新的令牌 |
| aop.auth-token-time-out | 访问令牌已过期 | 请刷新授权令牌或重新授权获取新的令牌 | ||
| aop.invalid-app-auth-token | 无效的应用授权令牌 | 请刷新应用授权令牌或重新授权获取新的令牌 | ||
| aop.invalid-app-auth-token-no-api | 商户未授权当前接口 | 请重新授权获取新的应用授权令牌 | ||
| aop.app-auth-token-time-out | 应用授权令牌已过期 | 请刷新应用授权令牌或重新授权获取新的令牌 | ||
| aop.no-product-reg-by-partner | 商户未签约任何产品 | ISV代理调用的场景，请上线商户的服务窗 | ||
| 40001 | 缺少必选参数 | isv.missing-method | 缺少方法名参数 | 请求参数里面必须要有method参数 |
| isv.missing-signature | 缺少签名参数 | 检查请求参数，缺少sign参数 | ||
| isv.missing-signature-type | 缺少签名类型参数 | 检查请求参数，缺少sign_type参数 | ||
| isv.missing-signature-key | 缺少签名配置 | 未上传公钥配置 | ||
| isv.missing-app-id | 缺少appId参数 | 检查请求参数，缺少app_id参数 | ||
| isv.missing-timestamp | 缺少时间戳参数 | 检查请求参数，缺少timestamp参数 | ||
| isv.missing-version | 缺少版本参数 | 检查请求参数，缺少version参数 | ||
| isv.decryption-error-missing-encrypt-type | 解密出错, 未指定加密算法 | 检查参数，缺少encrypt_type参数 | ||
| 40002 | 非法的参数 | isv.invalid-parameter | 参数无效 | 检查参数，格式不对、非法值、越界等 |
| isv.upload-fail | 文件上传失败 | 文件写入失败，重试 | ||
| isv.invalid-file-extension | 文件扩展名无效 | 检查传入的文件扩展名称，目前支持格式：csv,txt,zip,rar,gz,doc,docx,xls,xlsx,pdf,bmp,gif,jpg,jpeg,png | ||
| isv.invalid-file-size | 文件大小无效 | 检查文件大小，目前支持最大为：50MB | ||
| isv.invalid-method | 不存在的方法名 | 检查入参method是否正确 | ||
| isv.invalid-format | 无效的数据格式 | 检查入参format，目前只支持json和xml 2种格式 | ||
| isv.invalid-signature-type | 无效的签名类型 | 检查入参sign_type,目前只支持RSA,RSA2,HMAC_SHA1 | ||
| isv.invalid-signature | 无效签名 | 1.公私钥是否是一对 2.检查公钥上传是否与私钥匹配 3.存在中文需要做urlencode 4.签名算法是否无误 | ||
| isv.invalid-token | 无效令牌 | auth_token 为无效的令牌，请确认令牌有效 | ||
| isv.invalid-encrypt-type | 无效的加密类型 | 检查入参encrypt_type，目前只支持AES | ||
| isv.invalid-encrypt | 解密异常 | 重试 | ||
| isv.invalid-app-id | 无效的appId参数 | 检查入参app_id，app_id不存在，或者未上线 | ||
| isv.invalid-timestamp | 非法的时间戳参数 | 时间戳参数timestamp非法，请检查格式需要为"yyyy-MM-dd HH:mm:ss" | ||
| isv.invalid-charset | 字符集错误 | 请求参数charset错误，目前支持格式：GBK,UTF-8 | ||
| isv.invalid-digest | 摘要错误 | 检查请求参数，文件摘要参数必填 | ||
| isv.decryption-error-not-valid-encrypt-type | 解密出错，不支持的加密算法 | 检查入参encrypt_type，目前只支持AES | ||
| isv.decryption-error-not-valid-encrypt-key | 解密出错, 未配置加密密钥或加密密钥格式错误 | 没有配置加密密钥 | ||
| isv.decryption-error-unknown | 解密出错，未知异常 | 重试 | ||
| isv.missing-signature-config | 验签出错, 未配置对应签名算法的公钥或者证书 | 没有配置应用公钥 | ||
| isv.not-support-app-auth | 本接口不支持第三方代理调用 | 本接口不支持第三方代理调用 | ||
| isv.suspected-attack | 可疑的攻击请求 | 参考 https://opendocs.alipay.com/open/59/103663 特殊说明第3点，商户的请求参数中，所有的 key（支付宝关键 key 或者商户自己的 key），其对应的 value 中都不应该出现支付宝关键key，如 body、subject、service、out_trade_no、seller_id、total_fee 等，否则该类请求将可能被支付宝拦截，请更换相应参数名称。 | ||
| 40004 | 业务处理失败 | 对应业务错误码，明细错误码和解决方案请参见具体的 API 接口文档。 | ||
| 40006 | 权限不足 | isv.insufficient-isv-permissions | ISV 权限不足 | 请检查配置的账户是否有当前接口权限。 请在 开发者中心 ->我的应用找到对应的应用，在其 功能列表 中添加缺少的功能包、签约或申请必须的信息。详见 添加功能。 |
| isv.insufficient-user-permissions | 用户权限不足 | 代理的商户没有当前接口权限，ISV 可以选择让商户的应用自主添加功能后签约；或选择 代商户签约。 |
注意：
上表中为公共错误码。开发者在接入过程中遇到其他报错信息，可以参考所调用接口的 API 文档的“业务错误码”部分。
ISV 权限不足问题请参考 ISV 权限不足常见问题及解决办法。
SPI 错误码
在调用 SPI 时，外部商户响应报文中的统一错误码只有两种：10000 和 40004，具体信息如下图所示：
| code（返回码） | msg（返回码描述） | sub_code（明细返回码） | sub_msg（明细返回码描述） | 解决方案 |
| 10000 | Success（接口调用成功，调用结果请参考具体的SPI文档所对应的业务返回参数） | |||
| 40004 | Business Failed（业务处理失败） | 对应业务错误码，明细错误码和解决方案请参见具体的 SPI 文档。 |
公共错误码
公共错误码
更新时间：2020-02-06 22:17:51
支付宝网关会对开发者的接口非业务调用错误做统一处理，返回码如下：
API 公共错误码
| code（返回码） | msg（返回码描述） | sub_code（明细返回码） | sub_msg（明细返回码描述） | 解决方案 |
| 10000 | 接口调用成功，调用结果请参考具体的 API 文档所对应的业务返回参数。 | |||
| 20000 | 服务不可用 | isp.unknow-error | 服务暂不可用（业务系统不可用） | 稍后重试 |
| aop.unknow-error | 服务暂不可用（网关自身的未知错误） | 稍后重试 | ||
| 20001 | 授权权限不足 | aop.invalid-auth-token | 无效的访问令牌 | 请刷新授权令牌或重新授权获取新的令牌 |
| aop.auth-token-time-out | 访问令牌已过期 | 请刷新授权令牌或重新授权获取新的令牌 | ||
| aop.invalid-app-auth-token | 无效的应用授权令牌 | 请刷新应用授权令牌或重新授权获取新的令牌 | ||
| aop.invalid-app-auth-token-no-api | 商户未授权当前接口 | 请重新授权获取新的应用授权令牌 | ||
| aop.app-auth-token-time-out | 应用授权令牌已过期 | 请刷新应用授权令牌或重新授权获取新的令牌 | ||
| aop.no-product-reg-by-partner | 商户未签约任何产品 | ISV代理调用的场景，请上线商户的服务窗 | ||
| 40001 | 缺少必选参数 | isv.missing-method | 缺少方法名参数 | 请求参数里面必须要有method参数 |
| isv.missing-signature | 缺少签名参数 | 检查请求参数，缺少sign参数 | ||
| isv.missing-signature-type | 缺少签名类型参数 | 检查请求参数，缺少sign_type参数 | ||
| isv.missing-signature-key | 缺少签名配置 | 未上传公钥配置 | ||
| isv.missing-app-id | 缺少appId参数 | 检查请求参数，缺少app_id参数 | ||
| isv.missing-timestamp | 缺少时间戳参数 | 检查请求参数，缺少timestamp参数 | ||
| isv.missing-version | 缺少版本参数 | 检查请求参数，缺少version参数 | ||
| isv.decryption-error-missing-encrypt-type | 解密出错, 未指定加密算法 | 检查参数，缺少encrypt_type参数 | ||
| 40002 | 非法的参数 | isv.invalid-parameter | 参数无效 | 检查参数，格式不对、非法值、越界等 |
| isv.upload-fail | 文件上传失败 | 文件写入失败，重试 | ||
| isv.invalid-file-extension | 文件扩展名无效 | 检查传入的文件扩展名称，目前支持格式：csv,txt,zip,rar,gz,doc,docx,xls,xlsx,pdf,bmp,gif,jpg,jpeg,png | ||
| isv.invalid-file-size | 文件大小无效 | 检查文件大小，目前支持最大为：50MB | ||
| isv.invalid-method | 不存在的方法名 | 检查入参method是否正确 | ||
| isv.invalid-format | 无效的数据格式 | 检查入参format，目前只支持json和xml 2种格式 | ||
| isv.invalid-signature-type | 无效的签名类型 | 检查入参sign_type,目前只支持RSA,RSA2,HMAC_SHA1 | ||
| isv.invalid-signature | 无效签名 | 1.公私钥是否是一对 2.检查公钥上传是否与私钥匹配 3.存在中文需要做urlencode 4.签名算法是否无误 | ||
| isv.invalid-token | 无效令牌 | auth_token 为无效的令牌，请确认令牌有效 | ||
| isv.invalid-encrypt-type | 无效的加密类型 | 检查入参encrypt_type，目前只支持AES | ||
| isv.invalid-encrypt | 解密异常 | 重试 | ||
| isv.invalid-app-id | 无效的appId参数 | 检查入参app_id，app_id不存在，或者未上线 | ||
| isv.invalid-timestamp | 非法的时间戳参数 | 时间戳参数timestamp非法，请检查格式需要为"yyyy-MM-dd HH:mm:ss" | ||
| isv.invalid-charset | 字符集错误 | 请求参数charset错误，目前支持格式：GBK,UTF-8 | ||
| isv.invalid-digest | 摘要错误 | 检查请求参数，文件摘要参数必填 | ||
| isv.decryption-error-not-valid-encrypt-type | 解密出错，不支持的加密算法 | 检查入参encrypt_type，目前只支持AES | ||
| isv.decryption-error-not-valid-encrypt-key | 解密出错, 未配置加密密钥或加密密钥格式错误 | 没有配置加密密钥 | ||
| isv.decryption-error-unknown | 解密出错，未知异常 | 重试 | ||
| isv.missing-signature-config | 验签出错, 未配置对应签名算法的公钥或者证书 | 没有配置应用公钥 | ||
| isv.not-support-app-auth | 本接口不支持第三方代理调用 | 本接口不支持第三方代理调用 | ||
| isv.suspected-attack | 可疑的攻击请求 | 参考 https://opendocs.alipay.com/open/59/103663 特殊说明第3点，商户的请求参数中，所有的 key（支付宝关键 key 或者商户自己的 key），其对应的 value 中都不应该出现支付宝关键key，如 body、subject、service、out_trade_no、seller_id、total_fee 等，否则该类请求将可能被支付宝拦截，请更换相应参数名称。 | ||
| 40004 | 业务处理失败 | 对应业务错误码，明细错误码和解决方案请参见具体的 API 接口文档。 | ||
| 40006 | 权限不足 | isv.insufficient-isv-permissions | ISV 权限不足 | 请检查配置的账户是否有当前接口权限。 请在 开发者中心 ->我的应用找到对应的应用，在其 功能列表 中添加缺少的功能包、签约或申请必须的信息。详见 添加功能。 |
| isv.insufficient-user-permissions | 用户权限不足 | 代理的商户没有当前接口权限，ISV 可以选择让商户的应用自主添加功能后签约；或选择 代商户签约。 |
注意：
上表中为公共错误码。开发者在接入过程中遇到其他报错信息，可以参考所调用接口的 API 文档的“业务错误码”部分。
ISV 权限不足问题请参考 ISV 权限不足常见问题及解决办法。
SPI 错误码
在调用 SPI 时，外部商户响应报文中的统一错误码只有两种：10000 和 40004，具体信息如下图所示：
| code（返回码） | msg（返回码描述） | sub_code（明细返回码） | sub_msg（明细返回码描述） | 解决方案 |
| 10000 | Success（接口调用成功，调用结果请参考具体的SPI文档所对应的业务返回参数） | |||
| 40004 | Business Failed（业务处理失败） | 对应业务错误码，明细错误码和解决方案请参见具体的 SPI 文档。 |
