# 支付凭证查询订单接口

# 接口url

正式环境:https://service-sin.shengqugames-corp.com/payservice/queryPayOrderByPaymentNo

灰度联调环境:https://service-sin-gray.shengqugames-corp.com/payservice/queryPayOrderByPaymentNo

# 接口说明

通过支付凭证查询支付订单

# 接口加密及格式

hps协议

# 请求参数

字段名 类型 必填 说明
appId string Y 游戏ID
appMid string Y 游戏账号ID
channel string Y 渠道号 同发货协议
paymentNo string Y 支付凭证

# 响应参数

参数名 类型 说明
resultCode int 错误码
resultMsg string 错误描述
orderNo string 支付订单号
gameOrderNo string 游戏订单号
userId string 用户ID
product string 产品ID
extend string 扩展信息
channel string 支付渠道 google=谷歌 ios=苹果 onestore=OneStore mycard=MyCard unity-pc=pc统一支付收银台
platform string 支付平台 0=安卓 1=IOS 2=PC
mock string 沙盒订单 1=沙盒 0=正式
priceLocale string 支付货币(客户端上报)
priceAmount string 支付货币金额(客户端上报)
appId string 游戏ID
areaId string 区ID
paymentNo string 支付凭证
payTime string 支付时间
payStatus string 支付状态 0=未支付 1=已支付
notifyStatus string 通知状态 0=未通知 1=已通知

# 错误码列表

错误码 错误描述 说明
0 成功 成功
-10310657 appId为空或格式不正确 请校验请求参数
-10310712 iapOrderNo为空或格式不正确 请校验请求参数
-10310715 appMid为空或格式不正确 请校验请求参数
-10310719 channel为空或格式不正确 请校验请求参数
-10310687 paymentNo为空或格式不正确 请校验请求参数
-10310673 无渠道配置 请查看gpop后台配置
-10310671 无渠道配置 请查看gpop后台配置
-10310682 查无此订单 请校验请求参数
-10310713 请求iap服务器失败 请稍后再试
-10310720 未找到该支付凭证对应订单 请联系产品支持人员

# 公共错误码列表

参数名 错误描述 说明
-10242405 服务不存在,请稍后再试 请稍后再试
-10242400 服务错误,请稍后再试 请稍后再试
-10242504 访问超时,请稍后再试 请稍后再试
-10242500 服务内部错误,请稍后再试 请稍后再试
-10242404 网络错误,请确保网络通畅 请稍后再试
-10242488 服务忙,请稍后再试 请稍后再试
-10250013 URL不支持 请联系产品支持人员
-10250016 未授权访问此URL 请联系产品支持人员

# hps协议及签名方法

# hps协议接入标准

请求字段名 类型 必填 说明
merchant_name string Y 接入用户名 从接入平台获取
signature_method string Y 签名方法 目前固定MD5
signature string Y 签名 使用签名密钥按照签名算法计算, 签名密钥从接入平台获取
timestamp string Y Unix时间戳 1970年1月1日开始所经过的秒数
xxx 业务参数,见接口具体定义
响应字段名 类型 必填 说明
return_code int Y 0表示成功
return_message string Y 返回代码描述信息
data string N JSON格式, 见接口具体定义
签名算法: 
按照当前请求参数名的字母序进行升序排列(排序时区分大小写,除 signature 外,其它参数都参与签名),将所有参数-值组合以 key=value 的形式拼成一个新字符串,不同参数值之间没有任何分隔符,最后加上对应的签名密钥 secretKey 进行签名运算。如进行签名运算的串为:key1=value1key2=value2secretKey
1
2
Last Updated: 2023/11/10 05:56:20