文档中心 > JSSDK文档

交易定制接入JSSDK使用指南

更新时间:2019/10/11 访问次数:31271

答疑咨询 @清铄、菜问
咨询群:

Tida 交易定制接入指南

在页面head里引入tida.js 并附带上申请isv时候分配的appkey,该key将负责判断是否拥有某接口的权限,请正确填写。

<script src="//g.alicdn.com/tmapp/tida/3.3.51/tida.js?appkey=填入你的互动应用前台appkey"></script>
  • 注意:如果有多个页面,所有页面上集成的jssdk版本都需要是3.3.51
  • tida最新版本,请到 tida demo 中进行查阅

常见错误自查

  1. 调用接口后,跳转到 “对不起,系统繁忙,请稍后再试” 页面
    • 请确保调用 Tida.customization.buildOrder 接口的所在的页面 域名是 *.ews.m.jaeapp.com
    • 请确保调用 Tida.customization.buildOrder 接口的所在的页面 URL中没有#/,以免干扰传参,比如这个错误案例:https://*.ews.m.jaeapp.com/#/
    • 请确保调用 Tida.customization.buildOrder 接口的所在的页面 URL中携带以下参数,并满足以下格式
    https://*.ews.m.jaeapp.com?sellerNick=...&itemId=...&skuId=...&tradeToken=...&tb_order_host=...&from=native&...
    
    - sellerNick      :必传,卖家昵称
    - itemId          :必传,商品ID,
    - skuId           :可选,根据实际情况选择传与不传,或者传“0”
    - tradeToken      :必传,为服务端返回的token
    - tb_order_host   :可选,为下单的 host. 如果在预发的话,服务端会返回 buy.wapa.tmall.com,方便测试
    - from            :可选,可选值:native。是否通过hybrid方式调用native层接口?只在手淘生效
    • 如果是“C2B定制商品交易”场景,请 确保入参中的pic字段存在(必填)

C2B定制商品交易

  • Tida.customization.buildOrder
    • 接口说明:定制完成后调用下单方法。
    • 入参:
      • Object,必填,且pic字段也必填,代表定制的数据;
      • 默认数据格式为:
      {
          pic : [{id: 1, url:'xxx.jpg'}, {id: 2, url:'xxx.jpg'} ... ],
          text: [{id: 1, content: '文本1'}, {id: 2, content: '文本2'} ... ]
      }
      id为唯一id,数字,无实际意义;url 为图片的链接,必须为*.open_trade.*格式;content为文本内容。
      如特殊业务,需要和阿里的开发定交易的参数格式。
    • Function,可选,失败回调函数,只在手淘5.9.1+ 版本有效。其它将跳到下单失败页面。

    • 调用示例:
      var userParams = {
          pic : [{id: 23121, url: "https://img.alicdn.com/imgextra/i1/2055/TB2VNGlspXXXXaIXpXXXXXXXXXX_!!2055-0-open_trade.jpg"}],
          text: [{id: 12881, content:"我的定制文本"}]
      };
      Tida.customization.buildOrder(userParams, function(error){
          alert(JSON.stringify(error));
      });

      图片的url,通过taobao.trade.voucher.upload接口生成
      text不要都堆放到一个id里面,可以分开多个json数组堆放。总共的text.content不能超过255个字节

汽车服务商品

  • Tida.customization.buildOrder
    • 接口说明:完成服务的选择后调用下单方法。
    • 入参:
      • Object,必填
      • 默认数据格式为:
      { tradeExToken: trade_extend_token , tradeToken: trade_token }
      汽车服务的具体tradeExToken,里面包括了消费者自选的汽车服务内容(包括门店信息、车型信息、保养服务内容、消费者昵称、最终消费者需要支付的价格等,需要通过接口taobao.car.service.trade.create进行导入,拿到对应的tradeExToken),tradeToken字段,从商品页面跳转过来的时候,URL后会携带
    • Function,可选,失败回调函数,只在手淘5.9.1+ 版本有效。其它将跳到下单失败页面。

    • 调用示例:
      Tida.customization.buildOrder({ tradeExToken: trade_extend_token, tradeToken: trade_token });

运营商服务商品

  • Tida.customization.buildOrder
    • 接口说明:完成服务的选择后调用下单方法。
    • 入参:
      • Object,必填
      • 默认数据格式为:
      { tradeExToken: trade_extend_token, tradeToken: trade_token }
      运营商的具体tradeExToken,里面包括了消费者自选的服务(套餐信息、价格alibaba.aliqin.trade.create进行导入,拿到对应的tradeExToken),tradeToken字段,从商品页面跳转过来的时候,URL后会携带
    • Function,可选,失败回调函数,只在手淘5.9.1+ 版本有效。其它将跳到下单失败页面。

    • 调用示例:
      Tida.customization.buildOrder({ tradeExToken: trade_extend_token, tradeToken: trade_token });

更多文档

FAQ

关于此文档暂时还没有FAQ
返回
顶部