查询交易状态接口

该接口提供所有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&timestamp=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
	}
}