# 支付凭证查询订单接口
# 接口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
2