查询交易状态接口更新时间：2018-12-06
该接口提供所有MiracleGames支付订单的查询，开发者可以通过该接口主动查询订单状态，完成下一步的业务逻辑。 需要调用查询接口的情况： 当开发者后台、网络、服务器等出现异常，开发者系统最终未接收到支付通知； 调用支付接口后，返回系统错误或未知交易状态情况；
请求地址
| 环境 |
HTTPS请求地址 |
请求方式 |
| 正式环境 |
https://api.mguwp.net/epay/query |
GET |
请求参数
| 参数 |
类型 |
必填 |
描述 |
示例值 |
| project_id |
String(10) |
Y |
MiracleGames分配给开发者的项目ID |
1C77C16EEA |
| order_key |
String(1,64) |
Y |
商户订单号,64个字符以内、可包含字母、数字、下划线；需保证在商户端不重复 |
20150320010101001 |
| version |
String(3) |
Y |
调用的接口版本，固定为：1.0 |
1.0 |
| timestamp |
Long |
Y |
发送请求的时间截，MiracleGames只接收5分钟内发起的请求 |
1544504315622 |
| sign_type |
String(1,10) |
N |
商户生成签名字符串所使用的签名算法类型，目前支持MD5 |
MD5 |
| sign |
String(32) |
Y |
商户请求参数的签名串，详见【签名】 |
d80d242e0a4477c36dbe5241282e168f |
请求示例
https://api.mguwp.net/epay/create?project_id=1C77C16EEA&order_key=20150320010101001&version=1.0×tamp=1544504315622&sign=xxxxxx
响应参数
| 参数 |
类型 |
必填 |
描述 |
示例值 |
| code |
String(4) |
Y |
返回1000为正确请求，其它均为失败请求响应码【参考】 |
1000 |
| project_id |
String(10) |
Y |
MiracleGames分配给开发者的项目ID |
1C77C16EEA |
| trade_no |
String(1,32) |
Y |
MiracleGames交易号 |
20150320010101001 |
| order_key |
String(1,64) |
Y |
商户订单号,64个字符以内、可包含字母、数字、下划线；需保证在商户端不重复 |
20150320010101001 |
| trade_status |
String(1,10) |
Y |
交易状态，WAIT（等待玩家付款）、FAIL（交易失败）、SUCCESS（交易成功） |
|
| charset |
String(1,10) |
Y |
请求使用的编码格式 |
utf-8 |
| version |
String(3) |
Y |
调用的接口版本，固定为：1.0 |
1.0 |
| subject |
String(1,255) |
N |
订单标题，若为空，则默认为项目名称 |
100金币 |
| comment |
String(1,255) |
N |
自定义字段，异步通知时会返回给开发者 |
aaa,bbb,ccc |
| amount |
Price |
Y |
订单金额，单位为元，精确到小数点后两位，取值范围[0.01,1000] |
88.88 |
| currency |
String(3) |
Y |
货币单位（ISO 4217），目前只支持USD |
USD |
| num |
Integer |
N |
购买份数，若不填，则默认为1份。若设定此值且不等于1，则不支持点卡支付，即support_pointcard只能为0。 |
5 |
| country |
String(2) |
Y |
国家代码，若为空，则系统会根据玩家IP自动定位国家 |
CN |
| language |
String(2) |
N |
语言代码，若为空，则系统会根据玩家浏览器语言自动定位语言。目前只支持en、zh两种语言，除了zh(中文)之外，其它全部使用en。 |
zh |
| notify_url |
String(1,255) |
N |
异步通知地址，支付成功后，MiracleGames会从后端发起回调；若不填，则服务器主动通知商户项目里指定的页面http/https路径。【参考】 |
https://www.example.com/notify.htm |
| rate |
Decimal(10,2) |
Y |
交易费率，单位（%） |
5.0 |
| settle_amount |
Price |
Y |
结算金额 |
84.43 |
响应示例
{
"code": "1000",
"paymentinfo": {
"total_amount": 88.88,
"trade_no": "1C77C16EEA2018121712063788606485",
"subject": "testaaa",
"notify_url": "http:\/\/127.0.0.1\/a",
"charset": "UTF-8",
"order_status": "WAIT_BUYER_PAY",
"country": "cn",
"version": "1.0",
"currency": "USD",
"support_pointcard": 0,
"amount": 88.88,
"num": 1,
"rate": 5.0,
"order_key": "20150320010101002",
"project_id": "1C77C16EEA",
"create_time": "2018-12-17 12:06:54",
"settle_amount": 84.44,
"record_mode": "G1",
"language": "zh",
"real_num": null,
"comment": null
}
}