微币支付指南

出自微游戏开放平台WIKI

对微币支付指南的源代码

跳转到：导航, 搜索

如果没有通过支付申请，请使用[[微币沙箱环境]]进行支付测试，以便支付申请通过后快速接入。

沙箱环境的接入（测试）流程与正式接入流程相同，请参照下方内容。

=支付指南=
==支付流程==
用户在游戏兑换微币的实现流程概述如下：<br>
支付流程<br>
1. 用户在游戏兑换微币 <br>
2. 游戏调用[http://wyxwiki.appsina.com/index.php/1/pay/get_token pay/get_token] 接口(沙箱环境下调用[http://wyxwiki.appsina.com/index.php/1/test/pay/get_token test/pay/get_token]) 获取支付token , 并生成表单 , 表单概述如下（ [http://wyxwiki.appsina.com/index.php/%E5%BE%AE%E5%B8%81%E6%94%AF%E4%BB%98%E6%8C%87%E5%8D%97#.E8.A1.A8.E5.8D.95.E5.8F.82.E6.95.B0 1.2.2 表单参数];
[http://wyxwiki.appsina.com/index.php/%E5%BE%AE%E5%B8%81%E6%94%AF%E4%BB%98%E6%8C%87%E5%8D%97#.E8.A1.A8.E5.8D.95.E7.A4.BA.E4.BE.8B 1.2.3 表单示例]） 。 <br>
3. 用户提交表单到支付中心； <br>
4. 支付中心通知游戏是否支付成功；支付成功，则跳转回调地址url(及表单提交的returnUrl [http://wyxwiki.appsina.com/index.php/%E5%BE%AE%E5%B8%81%E6%94%AF%E4%BB%98%E6%8C%87%E5%8D%97#.E5.9B.9E.E8.B0.83.E5.8F.82.E6.95.B0 参数详情]）,兑换微币成功。<br>


==接口简略文档及示例代码==
<br>
1.[http://wyxwiki.appsina.com/index.php/1/pay/get_token 游戏获取token]<br>
====游戏获取token示例代码====
<pre  class="brush:js">
 $order_id = $orderIdPrev；(9位不重复的数字)。 
 $sign = md5( $orderId.'|'.$amount.'|'.$desc.'|'.$app_secret );
 $params = array
          (
	     'order_id' => $order_id ,
	     'amount' => $amount , //支付金额，单位分 大于0---500000。
	     'desc' => $desc ,     //支付描述 必须是utf-8编码
	     'sign' => $sign ,
          );

 $token = $weiyouxi->get('pay/get_token', $params);

 //沙箱环境
 //$token = $weiyouxi->get('test/pay/get_token', $params);
</pre>
[http://wyxwiki.appsina.com/index.php/1/pay/get_token 查看详情]<br>
<br>
2.生成表单 提交支付中心；

====表单参数====
{| border="1" cellspacing="0" cellpadding="0" width="100%" class="parameters" style="border-color: #CCCCCC;"
|-
!width="10%" style="text-align:left;font-weight:bolder;border:1px solid #cccccc"|参数名
!width="5%"  style="text-align:left;font-weight:bolder;border:1px solid  #cccccc"|必填
!width="20%" style="text-align:left;font-weight:bolder;border:1px solid #cccccc"|类型
!width="65%" style="text-align:left;font-weight:bolder;border:1px solid #cccccc"|说明
{{api_args|return_url|true|string|必选。支付成功跳转url（用于用户支付完毕后前端的成功跳转流程，约定为游戏方提供）. }}
{{api_args|order_id|true|int|必选。订单号，开放平台传入的订单号（该订单号用于，对账，客服支持等）。}}
{{api_args|order_uid|true|int64|必选。支付者的SinaUID (注 确保 order_uid 是64位整型 )。}}
{{api_args|desc|true|string|必选。必须是utf-8编码。}}
{{api_args|appkey|true|int|必选。开放平台的应用唯一标识。}}
{{api_args|amount|true|int|必选。支付金额，单位分 大于0---500000。(注:获取token时的金额必须与此金额一致)}}
{{api_args|version|true|string|必选。接口版本号(1.0)。}}
{{api_args|token|true|sring|开放平台的安全认证值。}}
|}

====表单示例====
<pre class="brush:js">
<!--[[沙箱环境]]下，表单接受地址是;http://open.weibo.com/paytest/payTestPay.php-->
 <form action="http://pay.weibo.com/wb/?c=pay" method="post" target="_top" style="display:none;" id="wyxPay">
          <input type="hidden" name="return_url(游戏地址)" value="<?php echo $returnUrl; ?>" />
 Order ID: <input type="text" name="order_id" value="<?php echo $orderId; ?>" readonly /> <br /><br />
          <input type="hidden" name="order_uid" value="<?php echo $token['order_uid']; ?>" />
 Desc    : <input type="text" name="desc" value="<?php echo $desc; ?>" readonly /><br /><br />
          <input type="hidden" name="appkey" value="<?php echo $appKey; ?>" />
          <input type="hidden" name="amount" value="<?php echo $amount; ?>" />
          <input type="hidden" name="version" value="1.0" />
 Token   : <input type="text" name="token" value="<?php echo $token['token']; ?>" readonly/><br /><br />
          <input type="submit" value="提交" />
 </form>
</pre>
<br>
3. 用户提交表单到支付中心；<br>
<br>
4. 支付成功后 通知游戏可以发货、用户点击 【返回应用】 的按钮 跳转回调地址url(及表单提交的returnUrl）,兑换微币成功。<br>
      回调接口描述：订单支付成功后支付中心通知游戏(回调接口)<br>
      请求方式：POST <br>

====回调参数====
<html><font color="red">请注意：回调地址是在我的游戏->支付功能页面填写的地址。</font></html>
{| border="1" cellspacing="0" cellpadding="0" width="100%" class="parameters" style="border-color: #CCCCCC;"
|-
!width="10%" style="text-align:left;font-weight:bolder;border:1px solid #cccccc"|参数名
!width="5%"  style="text-align:left;font-weight:bolder;border:1px solid  #cccccc"|必填
!width="20%" style="text-align:left;font-weight:bolder;border:1px solid #cccccc"|类型
!width="65%" style="text-align:left;font-weight:bolder;border:1px solid #cccccc"|说明
{{api_args|order_id|true|int|必选。开放平台订单号 }}
{{api_args|appkey|false|int|开放平台的应用唯一标识}}
{{api_args|order_uid|false|int|支付者的SinaUID}}
{{api_args|amount|true|int|必选。支付金额 单位分 大于0的整数}}
|}
返回值：4项参数，游戏返回状态为200，且返回字符串为"OK"（注意是大写）。则回调成功，否则开放平台会尝试回调3次。
如果3次都没有回调成功，则不再回调。游戏自己调用[http://wyxwiki.appsina.com/index.php/1/Pay/order_status 查询订单状态]。<br>
<br>
5.[http://wyxwiki.appsina.com/index.php/1/Pay/order_status 查询订单状态]<br>

====查询订单状态示例代码====
<pre  class="brush:js">
 $params = array
          (
	      'order_id' => $order_id ,//支付ID(汇总信息页面,7位) . 9位数字（不能重复,以免订单号重复)，总长度必须为16位)
	      'user_id' => $user_id ,    //支付者的SinaUID
	      'app_id' => $appKey ,     //开放平台的应用唯一标识
	      'sign' => $sign ,         //md5( $order_id.'|'.$app_secret );
          );
 //沙箱环境
 //$token = $weiyouxi->get('test/pay/order_status', $params);
 $orderStatus = $weiyouxi->get('pay/order_status', $params);
</pre>
[http://wyxwiki.appsina.com/index.php/1/Pay/order_status 查看详情]<br>

==错误代码==
错误代码	说明
* 1	支付成功
* 1000	开放平台订单号不合法
* 1001 returnUrl参数不合法
* 1002 商户订单号不合法
* 1003 用户id不合法
* 1004 商品名不合法
* 1005 appkey不合法
* 1006 金额不合法
* 1008 token不合法
* 1010 验证token失败
* 1011 后台通知地址不合法
* 1012 订单初始化失败
* 1013	支付失败，错误不在错误列表中
* 1014	系统繁忙请稍候再试
* 1015	ip不合法，没有使用权限
* 1017	该订单号不存在
* 1018	该订单处于初始化状态
* 1019	该订单已经完成
* 1020	该订单正在进行中
* 1021	订单详情有错
* 1022	订单已经过期，请重新发起
* 1023	开放平台应用编号不合法

模板:Api args (查看源码)

返回到微币支付指南。

取自“http://game.weibo.comhttp://open.weibo.com/game/index/wiki?title=%E5%BE%AE%E5%B8%81%E6%94%AF%E4%BB%98%E6%8C%87%E5%8D%97”