发起支付请求更新时间:2018-12-06
商户通过该接口进行交易的创建下单
请求地址
环境 |
HTTPS请求地址 |
请求方式 |
正式环境 |
https://api.mguwp.net/epay/create |
GET |
请求参数
参数 |
类型 |
必填 |
描述 |
示例值 |
project_id |
String(10) |
Y |
MiracleGames分配给开发者的项目ID |
1C77C16EEA |
order_key |
String(1,64) |
Y |
商户订单号,64个字符以内、可包含字母、数字、下划线;需保证在商户端不重复 |
20150320010101001 |
charset |
String(1,10) |
N |
请求使用的编码格式,目前只支持utf-8 |
utf-8 |
version |
String(3) |
Y |
调用的接口版本,固定为:1.0 |
1.0 |
subject |
String(1,255) |
N |
订单标题,若为空,则默认为项目名称 |
100金币 |
body |
String(1,255) |
N |
订单内容 |
|
comment |
String(1,255) |
N |
自定义字段,异步通知时会返回给开发者 |
aaa,bbb,ccc |
notify_url |
String(1,255) |
N |
异步通知地址,支付成功后,MiracleGames会从后端发起回调;若不填,则服务器主动通知商户项目里指定的页面http/https路径。【参考】 |
https://www.example.com/notify.htm |
return_url |
String(1,255) |
N |
服务器同步返回的页面http/https路径 |
https://www.example.com/payment.htm |
cancel_url |
String(1,255) |
N |
取消订单时返回的页面http/https路径 |
https://www.example.com/cancel.htm |
amount |
Price |
Y |
订单金额,单位为美元,精确到小数点后两位,取值范围[0.01,1000] |
88.88 |
currency |
String(3) |
Y |
货币单位(ISO 4217),目前只支持USD |
USD |
country |
String(2) |
N |
国家代码,若为空,则系统会根据玩家IP自动定位国家 |
CN |
num |
Integer |
N |
购买份数,若不填,则默认为1份。若设定此值且不等于1,则不支持点卡支付,即support_pointcard只能为0。 |
5 |
language |
String(2) |
N |
语言代码,若为空,则系统会根据玩家浏览器语言自动定位语言。目前只支持en、zh两种语言,除了zh(中文)之外,其它全部使用en。 |
zh |
support_pointcard |
Integer |
N |
是否支持点卡支付。0=不支持;1=支持。若不填写,则默认为0(不支持)。 |
0 |
payment_type |
String(1,4) |
N |
渠道类型标识 |
A1=支付宝;B=PayPal;D=Fortumo;E=Paymentwall;F=Lumi;G1=微信;H=MOL;I=VISA;ID1=UniPin;ID2=CodaPay;J=MyCard;K=APACPAY;L=Skrill;M=奇游币;MY1=GamesBerry;N=Appota;O=vnpt epay;P=Payssion;Q=SafeCharge;R=QiWi;S=微软支付;T=Yandex;TH1=BluePay;U=XSOLLA;V=Rixty;W=BOACOMPRA;X=OneCard;Y=Pagsmile; |
payment_code |
String(1,30) |
N |
子渠道标识 |
详情资讯客服人员 |
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&amount=88.88¤cy=USD×tamp=1544504315622&sign=xxxxxx