阿里TV开放平台文档

浏览13462
更新时间2022-04-11

支付流程说明

1434706053921_a87ff679a2f3e71d9181a67b7542122c.jpg

消费流程:

1) 用户在App中发起支付,App调用SDK支付接口payFromServer

2) SDK与Ali服务端进行支付确认后,向用户显示支付页面

3) 用户确认支付后,SDK向Ali服务端发起并完成支付

4) Ali服务端 将支付结果反馈给SDK,并通知App服务端

5) App服务端通过回调的订单信息,决定是否向App的用户发放道具


 

网络应用支付接口

接口说明:

App服务端将支付参数传递给App,App调用支付接口payFromServer完成支付
阿里服务端将支付结果通知SDK和App服务端,App服务端决定道具是否发放

前置条件:

函数原型:

public static void payFromServer(String title, String amount, String orderId, String notifyUrl,String subjectId, IPayListener payListener)

参数说明:

title:支付物品名称 ,如“宝石”

amount:人民币“分” (如amount =100,代表1元人民币)

subjectId商品ID(用于参与激励活动商品标示,由CP自定义)可选

orderId:订单号,CP的服务端生成

notifyUrl:支付结束后,阿里服务器回调给CP服务器的回调地址

payListener:回调函数,支付结束后通知App客户端成功或者失败。

 

请求样例:


Stringamount = “2”;
             String title ="支付人民币0.02元";
             finalString orderId = System.currentTimeMillis() +"";
             // App服务端提供回调接口,用于接收支付成功的消息
             String notifyUrl ="http://xxxx.com/callback/notify";
             AliTvSdk.payFromServer(title, amount,orderId, notifyUrl,subjectId,
                           newIPayListener() {
                                  @Override
                                  publicvoidonSuccess(String title,intamount) {
                                         TestToast.show("二维码扫码支付成功");
                                  }
                                  @Override
                                  publicvoidonError(String title,intamount, String errMsg) {
                                         TestToast.show("二维码扫码支付失败,原因:"+ errMsg);
                                  }
                                 @Override
                                  publicvoidonCancel(String title,intamount) {
                                         TestToast.show("二维码扫码支付取消");
                                  }
                           });


 

 

服务端支付成功后回调通知

接口说明:

第三方应用需要开发一个HTTP服务,并提供的服务器接口地址,比如:http://第三方应用服务端地址/XXX 数娱服务端使用商户提供的公钥(public_key)对参数加密生成加密串encryptString(解密出来为json格式),并在app请求提供的URL(参数为:notify_url)中加入本次成功的订单信息加密串(格式为:notify_url?data=encryptString) 数娱服务端将上述信息 向APP服务端发送http请求,若收到返回信息为“success”,则发送成功,若返回信息为其他,递增时间间隔重发。

Data解密后数据结构

键名(key)

(value)

partner_order_no

商户订单号

alipay_trade_no

支付宝交易流水号

order_status

订单状态

WAIT_BUYER_PAY等待买家支付

TRADE_SUCCESS 支付成功

TRADE_CLOSED交易关闭

buyer_logon_id

付款方支付宝账号

 

 

服务器端主动查询订单支付状态

接口说明

商户可以通过该接口主动查询订单支付状态,主要用于客户端支付成功后,商户接到收支付成功后主动查询一次,用于验证订单是否已支付成功。

接入方式:TOP

TOP接入指南见://open.taobao.com/doc2/detail.htm?spm=a219a.7629140.0.0.jlQptD&treeId=49&articleId=101617&docType=1

APItaobao.tvpay.partner.order.query

请求参数结构:

参数名称

参数说明

是否必填

详情

order_no

商户订单号

商户自己的订单号

返回基础结构说明

字段

说明

code

success:成功

message

提示信息或错误信息

data.data

返回业务参数(需要RSA方式使用私钥解密,得到json串并解析成结构化的data参数)

返回基础结构样例:

{
   "tvpay_partner_order_query_response": {
       "result": {
           "code": "success",
           "data": {
               "data": "PG5Qgxp5C+Muqohd7s01IE9SK/VnYVSxsY7nPqHFR8d+tjx3qLBeTu8llVi0+yaQHdMl/ZMTXxhchl9FiruOkX+GL5aN4S+/C68Tq5Os5dT4iilwNaDT6gw2pBtMUR9maVfXukcvFMLSx7d9XsjebWpapqTMgjOkMQjOHUA0GtcdgfFPE4sFxwB0+8SdbOYF1qoEkBoU8o0brd6/tFTJkqn/uJUbHOoqqLXCB3LmxShRa4m8KRsVPfSavOEjcSO7yfNTu7cLhGoOCRL5ffwLWVxyPRpaLfm0O8CJi9Cllb5nndWzh1zoXUtyBdfw9iHzbE0C7WArO5+YLKVCzA5c4A=="
           },
           "message": "success",
           "success": true
       },
       "request_id": "118g71ywn59zf"
   }
}

 

data解密后数据结构:

键名(key)

(value)

partner_order_no

商户订单号

alipay_trade_no

支付宝交易流水号

order_status

订单状态

WAIT_BUYER_PAY等待买家支付

TRADE_SUCCESS 支付成功

TRADE_CLOSED交易关闭

price

订单价格,以人民币分为单位

subject

商品标题

subject_id

商品id

buyer_logon_id

付款方支付宝账号

 

相关视频

更多

免费

php8,我来也
初级php8,我来也

33.5万次学习

收藏

免费

Thinkphp6.0正式版视频教程
中级Thinkphp6.0正式版视频教程

39.2万次学习

收藏

免费

细说PHP第一季
中级细说PHP第一季

30.3万次学习

收藏

精品课程

更多
前端入门_HTML5
前端入门_HTML5

共29课时

64.4万人学习

CSS视频教程-玉女心经版
CSS视频教程-玉女心经版

共25课时

40.9万人学习

JavaScript极速入门_玉女心经系列
JavaScript极速入门_玉女心经系列

共43课时

76万人学习

独孤九贱(1)_HTML5视频教程
独孤九贱(1)_HTML5视频教程

共25课时

63.7万人学习

独孤九贱(2)_CSS视频教程
独孤九贱(2)_CSS视频教程

共22课时

24.1万人学习

独孤九贱(3)_JavaScript视频教程
独孤九贱(3)_JavaScript视频教程

共28课时

35.8万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时

131.8万人学习

热门下载

更多
phpStudy 2018最新版
phpStudy 2018最新版

集成PHP7,16种组合,超全大合集

下载

VC9 32位
VC9 32位

VC9 32位 phpstudy集成安装环境运行库

下载

VC11 32位
VC11 32位

VC11 32位 phpstudy集成安装环境运行库​

下载

php程序员工具箱完整版
php程序员工具箱完整版

程序员工具箱 v1.0 php集成环境

下载

VC14 32位
VC14 32位

VC14 32位 phpstudy安装环境运行库

下载

SublimeText3汉化版
SublimeText3汉化版

中文版,非常好用

下载

Notepad++ Windows版
Notepad++ Windows版

Notepad++ 8.9.7 Windows版官方安装包,适合 Windows 用户进行代码编辑、文本处理、语法高亮和插件扩展配置。

下载