微博开放平台
微连接
移动应用
网站接入
电商服务商
电商商家
数据服务
数据服务
合作伙伴
微博支付
轻应用
粉丝服务
文档
推广
我的应用
登录
weibo
开发文档
首页
平台政策与指引
概述
平台公约
新手指南
开发者协议
应用运营管理规范
微连接分级管理办法
应用审核产品指南
应用安全开发注意事项
平台应用设计规范
微服务接入指南
微博登录接入
用微博帐号登录
授权机制
移动应用接入
移动应用介绍
移动应用SSO授权
微博Deep Link
媒体接入平台
头条文章开放接口
视频上传开放接口
电商接入平台
电商服务商接入
电商商家端接入
电商平台能力接口
粉丝服务平台
粉丝服务平台
新手接入指南
微信开发者迁移指南
接收消息
发送消息
自定义菜单
用户管理
生成带参数的二维码
Fans Service Platform
商业接口
商业数据接入指南
订阅服务手册(中文版)
订阅服务手册(英文版)
商业接口-REST API
商业数据常见问题
网站接入
网站接入介绍
微博API
微博API
接口访问频次权限
资源下载
SDK
微博标识下载
常见问题
联系我们
工具箱
链入页面
链出更改
特殊页面
查看源代码
跳转到:
导航
,
搜索
根据下列原因,你没有权限编辑本页:
您刚才请求的操作只有这个用户组中的用户才能使用:
用户
您可以查看并复制此页面的源代码:
==get_token == *用户发起支付时,应用开发者调用get_token接口,获取支付token,开放平台验证应用的相关信息,验证成功后,返回token值。 *应用开发者申请开通支付功能时,需要填写回调地址(参见[[回调接口|回调接口]]);当用户付款成功后,开放平台通过此回调地址通知应用开发者订单支付状态。 *查询“支付ID”: 在”开放平台->应用汇总信息页”,可查看应用是否开通支付功能,存在“支付ID”,则表示该应用的支付功能已开通。 ==URL== * 线上接口URL:http://api.t.sina.com.cn/pay/get_token.format ==支持格式== *'''JSON/XML''' ==HTTP请求方式== *'''GET/POST''' ==是否需要登录== *'''true''' *关于登录授权,参见 [[授权机制说明|如何登录授权]] ==请求参数== <table border="1" cellspacing="0" cellpadding="0" width="100%" class="parameters" style="border-color: #CCCCCC;"> <tr> <th width="15%" style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc">参数名</th> <th width="10%" style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc">必填</th> <th width="10%" style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc">类型</th> <th width="65%" style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc">说明</th> </tr> <tr> <th width="15%" style="text-align:left;padding-left:5px;border:1px solid #cccccc">'''order_id'''</th> <th width="10%" style="text-align:left;padding-left:5px;border:1px solid #cccccc">true</th> <th width="10%" style="text-align:left;padding-left:5px;border:1px solid #cccccc">string</th> <th width="65%" style="text-align:left;padding-left:5px;border:1px solid #cccccc">订单id,(为 了避免重复,需要以orderid_pre开 头(7位) 即为 支付ID, 总长 度必须为16位)</th> </tr> <tr> <th width="15%" style="text-align:left;padding-left:5px;border:1px solid #cccccc"> '''amount'''</th> <th width="10%" style="text-align:left;padding-left:5px;border:1px solid #cccccc">true</th> <th width="10%" style="text-align:left;padding-left:5px;border:1px solid #cccccc">int</th> <th width="65%" style="text-align:left;padding-left:5px;border:1px solid #cccccc">交易金额,单位:分 范围 1-- 500000分</th> </tr> <tr> <th width="15%" style="text-align:left;padding-left:5px;border:1px solid #cccccc"> '''desc'''</th> <th width="10%" style="text-align:left;padding-left:5px;border:1px solid #cccccc">true</th> <th width="10%" style="text-align:left;padding-left:5px;border:1px solid #cccccc">string</th> <th width="65%" style="text-align:left;padding-left:5px;border:1px solid #cccccc">交易描述,最多50个 汉字 (URLEncode)</th> </tr> <tr> <th width="15%" style="text-align:left;padding-left:5px;border:1px solid #cccccc">'''sign'''</th> <th width="10%" style="text-align:left;padding-left:5px;border:1px solid #cccccc">true</th> <th width="10%" style="text-align:left;padding-left:5px;border:1px solid #cccccc">string</th> <th width="65%" style="text-align:left;padding-left:5px;border:1px solid #cccccc">签名值sign=md5(order_id|amount|desc|app_secret),’|’是竖线</th> </tr> <tr> <th width="15%" style="text-align:left;padding-left:5px;border:1px solid #cccccc">'''source'''</th> <th width="10%" style="text-align:left;padding-left:5px;border:1px solid #cccccc">true</th> <th width="10%" style="text-align:left;padding-left:5px;border:1px solid #cccccc">string</th> <th width="65%" style="text-align:left;padding-left:5px;border:1px solid #cccccc">申请应用时分配的AppKey,调用 接口 时候 代表应用的唯一身份。(采用OAuth授 权方式不需要此参数)</th> </tr> </table> ==相关约束== *无 ==注意事项== *1) 请求参数只需要 order_id amount desc sign source五个参数 *2) 线上环境:如果当天“支付功能审核通过(获得支付ID)”,需要明天早上10点左右才可以正常调用接口。 ==PHP调用示例== <pre> //使用SDK调用接口 try { $c = new SaeTClient( WB_AKEY , WB_SKEY ,$_SESSION['oauth2']['oauth_token'] ,'' ); $order_id = 1234567891234567;//订单id(需要以order_id_pre开头(7位)即为支付ID(汇总信息页面) ) + (后9位id不能重复,以免订单号重复) 。)总长度必须为16位 $amount = 1; //交易金额 $desc = '在XX游戏中支付(1/100) 微币';//交易描述,最多50个汉字 。 $data= $c->pay_get_token( $order_id, $amount, $desc ) var_dump( $data ); } catch( Exception $e ) { var_dump($e); } </pre> ==返回结果== ===JSON示例=== <pre> //支付成功 {"token":"***", "order_uid":"***"} </pre> ===XML示例=== <pre> //支付成功 <result><token>***</token><order_uid>***</order_uid></result> </pre> Order_uid 解释:支付者的SinaUID ==错误情况的返回码描述== 在参数验证错误,或请求非法时,根据不同的情况,会返回不同的错误码(error_code): 例如: {"request":"http://10.73.14.130/pay/get_token.json","error_code":23610,"error":"sign is invalid!"} <table border="1" cellspacing="0" cellpadding="0" width="100%" class="parameters" style="border-color: #CCCCCC;"> <tr> <th width="10%" style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc">error_code</th> <th width="30%" style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc">error</th> <th width="50%" style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc">中文含义</th> </tr> <tr> <th width="10%" style="text-align:left;padding-left:5px;border:1px solid#cccccc">23601</th> <th width="30%" style="text-align:left;padding-left:5px;border:1px solid#cccccc">appkey has no privilege for pay!</th> <th width="50%" style="text-align:left;padding-left:5px;border:1px solid#cccccc">应用没有开通支付权限!</th> </tr> <tr> <th width="10%" style="text-align:left;padding-left:5px;border:1px solid#cccccc">23602</th> <th width="30%" style="text-align:left;padding-left:5px;border:1px solid#cccccc">order_id is null!</th> <th width="50%" style="text-align:left;padding-left:5px;border:1px solid#cccccc">order_id参数为空!</th> </tr> <tr> <th width="10%" style="text-align:left;padding-left:5px;border:1px solid#cccccc">23603</th> <th width="30%" style="text-align:left;padding-left:5px;border:1px solid#cccccc">orderid_pre is null!</th> <th width="50%" style="text-align:left;padding-left:5px;border:1px solid#cccccc">orderid_pre为空,没有获取到支付应用ID!</th> </tr> <tr> <th width="10%" style="text-align:left;padding-left:5px;border:1px solid#cccccc">23604</th> <th width="30%" style="text-align:left;padding-left:5px;border:1px solid#cccccc">order_id is invalid!</th> <th width="50%" style="text-align:left;padding-left:5px;border:1px solid#cccccc">order_id格式非法! order_id必须为16位长,由两部分组成:支付应用ID (7位)+第三方订单号(9位)。</th> </tr> <tr> <th width="10%" style="text-align:left;padding-left:5px;border:1px solid#cccccc">23605</th> <th width="30%" style="text-align:left;padding-left:5px;border:1px solid#cccccc">order_id is invalid!</th> <th width="50%" style="text-align:left;padding-left:5px;border:1px solid#cccccc">order_id非法! 例如,使用一个已存在的订单号,但传递不同的amount、或不同的uid来请求token。</th> </tr> <tr> <th width="10%" style="text-align:left;padding-left:5px;border:1px solid#cccccc">23606</th> <th width="30%" style="text-align:left;padding-left:5px;border:1px solid#cccccc">amount is invalid!</th> <th width="50%" style="text-align:left;padding-left:5px;border:1px solid#cccccc">amount必须为1~500000分! </tr> <tr> <th width="10%" style="text-align:left;padding-left:5px;border:1px solid#cccccc">23607</th> <th width="30%" style="text-align:left;padding-left:5px;border:1px solid#cccccc">desc is null!</th> <th width="50%" style="text-align:left;padding-left:5px;border:1px solid#cccccc">desc不能为空!</th> </tr> <tr> <th width="10%" style="text-align:left;padding-left:5px;border:1px solid#cccccc">23608</th> <th width="30%" style="text-align:left;padding-left:5px;border:1px solid#cccccc">length of desc can't more 100!</th> <th width="50%" style="text-align:left;padding-left:5px;border:1px solid#cccccc">desc长度必须小于100个字节(即50个汉字)!</th> </tr> <tr> <th width="10%" style="text-align:left;padding-left:5px;border:1px solid#cccccc">23609</th> <th width="30%" style="text-align:left;padding-left:5px;border:1px solid#cccccc">sign is null!</th> <th width="50%" style="text-align:left;padding-left:5px;border:1px solid#cccccc">sign不能为空!</th> </tr> <tr> <th width="10%" style="text-align:left;padding-left:5px;border:1px solid#cccccc">23610</th> <th width="30%" style="text-align:left;padding-left:5px;border:1px solid#cccccc">sign is invalid!</th> <th width="50%" style="text-align:left;padding-left:5px;border:1px solid#cccccc">sign经过md5计算后,不匹配!</th> </tr> </table> 其他错误情况,为调用平台其他接口的返回值情况一样。例如没有传递source,会返回: {"request":"http://10.73.14.130/pay/get_token.json","error_code":10006,"error":"source paramter(appkey) is missing"} ==其他== *无 __NOTOC__
返回到
Pay/get token
。
反馈
分享
顶部