SparkPay OpenAPI 文档
简体中文
  • 简体中文
  • English
简体中文
  • 简体中文
  • English
  1. 接入必读
  • 产品介绍
  • 快速指引
    • 接入准备
    • 接口加签说明
  • 接入必读
    • 接口规则
    • 异步通知
    • 接口错误码
    • 网络与币种
  • 对接场景
    • 支付
    • 关闭订单
  • API列表
    • 统一收银台付款
      POST
    • 支付订单关闭
      POST
    • 支付订单查询
      GET
    • 统一收银台付款(专业版)
      POST
    • 支付订单查询(专业版)
      GET
  • 常见问题
    • 通知相关问题
    • 跳转失败问题
    • 接口报错提示问题
    • 测试币领取/测试网连接
  • 对接示例
    • 接口签名示例-Postman
    • 接口签名示例-php
  • 版本说明
    • 版本说明
  1. 接入必读

接口错误码

错误码类型错误原因错误说明解决方案
40000number错误请求参数接口参数验签失败请求业务数据签名,要求签名私钥与在商户平台上传的公钥是一对匹配的RSA公私钥。
40001number错误请求参数接口参数解密失败对请求报文中AES密钥加密使用的公钥,要求是支付平台RSA公钥。请商户前往商户平台登录,进入“应用”页查看下载。
40002number错误请求参数APPID无效检查APPID是否正确。
40003number错误请求参数请求缺少必需参数检查参数是否齐全。
40004number错误请求参数证件类型不支持检查证件类型是否正确,目前支持的类型为:ID:身份证。PASSPORT: 护照。
40005number错误请求参数手机号格式不支持检查手机号格式是否正确。
40006number错误请求参数提供的证件信息不全检查证件类型和证件号是否齐全。
40007number错误请求参数APPID不属于该商户前往商户平台登录,进入“应用”页查看APPID。
40008number错误请求参数商户号不存在检查商户号是否正确。
40009number错误请求参数参数错误要求参数值与在线接口文档中类型一致,请确认参数问题。
40010number错误请求参数不支持该地区用户开户咨询spark官方运营人员对所在地区的未来支持计划。
40011number错误请求参数应用调用次数超限降低接口的请求频率,稍后重试。
40012number错误请求参数邮箱格式不支持检查邮箱格式是否正确。
40013number错误请求参数未经授权需要在请求接口的HTTP Header中"Authorization"携带授权凭证,详情请参考接口文档(根据授权令牌查询授权信息接口)。
40014number错误请求参数账号已存在指定手机号/邮箱在SPARK中已经存在账户,如果需要获取用户的SPARK账户信息,需要调用SPARK用户授权相关接口,即通过用户授权获取用户信息。
40015number错误请求参数用户信息获取异常用户是其他商户应用开户的用户,需要调用SPARK用户授权相关接口,即通过用户授权获取用户信息。
40016number错误请求参数国家地区不在商户的展业区域区内,无法开户请商户支持用户所在地区作为展业区域。
40017number错误请求参数国家代码和手机号不匹配请使用该手机号对应的国家代码,详见国家代码表。
40018number错误请求参数国家代码无效检查国家代码格式是否正确。详见国家代码表。
41000number错误请求参数回调通知url不符合规则检查url格式是否正确。
41001number错误请求参数异步通知url不符合规则检查url格式是否正确。
41002number错误请求参数商户未激活联系spark官方运营管理人员协助激活。
41003number错误请求参数付款人未开户付款人需要是已开户的账户。
41005number错误请求参数分账类型不支持检查分账类型是否正确,目前支持的类型为:1: 商户号。2: 钱包用户。
41006number错误请求参数分账用途不支持检查分账用途是否正确,目前支持的类型为:1:主交易金额。2:商户服务费。3:其他费用。
41007number错误请求参数商户分账金额必须大于平台服务费检查分账金额是否正确,分账金额必须大于任一网络上平台服务费(平台服务费 = 订单金额 * 服务费率,当计算金额≤最小服务费时以最小服务费为准)。
41008number错误请求参数分账订单金额与订单总金额不匹配检查分账金额是否正确。
41009number错误请求参数付款币种不支持检查订单币种是否正确,目前支持的币种为:USDT。
41010number错误请求参数分账账户未开户分账账户需要是已开户的账户。
41011number错误请求参数分账账户未激活分账账户需要是已激活的账户。
41012number错误请求参数商户订单已过期商户平台订单支付截止时间是否正确。
41013number错误请求参数商户订单总金额不符合规则检查订单总金额是否正确。
41014number错误请求参数分账金额不符合规则检查分账金额是否正确。
41015number错误请求参数分账订单缺少主收款人检查分账订单主收款人是否提供。
41016number错误请求参数分账订单不支持多个主收款人检查分账订单是否唯一主收款人。
41017number错误请求参数服务费商户与下单商户客户号不一致检查服务费商户或下单商户客户号是否正确。
41018number错误请求参数订单总金额超出最大精度检查订单总金额是否正确。
41019number错误请求参数分账金额超出最大精度检查分账订单分账金额是否正确。
41021number错误请求参数超时时间应大于下单时间检查订单超时时间是否正确。
41022number错误请求参数付款人与收款人不能相同检查订单收款人是否正确。
41023number错误请求参数请求编号不符合规则检查请求编号是否正确。
41025number错误请求参数分账类型与分账用途不匹配检查分账类型与分账用途是否正确,目前规则为:钱包用户分账用途为主交易金额,商户分账用途为商户服务费或其他费用。
41026number错误请求参数分账订单缺少商户检查分账订单是否提供商户收款。
41027number错误请求参数订单收款网络不支持检查订单收款网络是否正确。
41028number错误请求参数支付订单金额必须大于最小平台服务费检查订单金额是否正确,订单金额必须大于任一网络上最小平台服务费。
41029number错误请求参数分账人信息错误检查有重复的分账人。
41030number错误请求参数不支持下单商户付款检查付款人是否正确。
41031number错误请求参数收款网络不支持该币种。
41032number错误请求参数分账收款地址不正确。
41033number错误请求参数分账收款地址存在重复。检查每个分账的收款地址,确保不重复。
41034number错误请求参数分账地址不能有商户CA地址。检查每个分账的收款地址,收款地址不能为商户CA地址。
41035number错误请求参数当前网络未配置收款地址,请先进行配置。登录商户后台系统,在相应的收款网络中设置外部地址。
41036number错误请求参数可用接收网络中存在相同的币种。检查参数available_payment_currency_networks,确保同一网络下币种不重复。
41037number错误请求参数可用接收网络中存在相同的网络。检查参数available_payment_currency_networks,确保网络不重复。
41038number错误请求参数所有可用接收网络中都不满足最小服务费要求请尝试设置更大的定价金额或者卖家金额。
41039number错误请求参数在线支付未开通请咨询spark官方工作人员开通在线支付业务。
43000number错误请求参数商户余额不足商户余额不足,请用户充值。
43005number错误请求参数支付订单不存在检查支付订单编号是否正确。
43006number错误请求参数该订单不支持关闭该订单因为状态或系统限制等原因不能关闭。
43007number错误请求参数该订单已关闭订单已关闭,无需更多操作。
43008number错误请求参数该客户未开户接口参数中的客户需是已开户的账户。
43011number错误请求参数超过单个订单最大分账笔数调整分账订单的分账笔数后重新下单。
44000number错误请求参数授权码无效授权码已过期,需要重新发起用户授权。
44001number错误请求参数授权成功回调地址与授权码不匹配检查参数redirect_url和code是否对应,code要对应商户注册应用时的接收授权码的回调地址。
44002number错误请求参数无效的身份验证信息检查参数client_id是否正确。
44003number错误请求参数无效的授权类型检查授权类型是否正确,目前支持的授权类型有:refresh_token:刷新令牌。authorization_code:获取授权令牌。
44004number错误请求参数刷新令牌无效获取授权令牌接口返回的refresh_token已过期,需要重新发起用户授权。
50000number系统异常内部系统错误系统异常,请用相同参数重新调用。
修改于 2025-02-25 03:08:13
上一页
异步通知
下一页
网络与币种
Built with