发起支付请求

商户通过该接口进行交易的创建下单

请求地址

环境 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&currency=USD&timestamp=1544504315622&sign=xxxxxx