开发者在开发过程中，但凡涉及到佣金，必须用到高效转链接口，对此开放平台对高效转链接口重要字段进行说明，让您能够更快速的接入。

一、请求参数

1. pid：非必填，值为mm_xxx_xxx_xxx。当您在推广中心设置了默认pid后，如果不需要更换pid，就不需要传递本参数，此时接口默认会调用您设置的pid。当您需要换为同一淘客帐号下的其它pid，那么就传递本pid参数 

2.goodsId：必填，值为商品淘宝ID。可通过商品列表或者其他栏目获取到商品淘宝ID填入进行转链

3.couponId ：非必填，值为优惠券ID。一个商品在联盟可能有多个优惠券，可通过填写该参数的方式选择使用的优惠券（请确认优惠券ID正确，否则无法正常跳转）

4.channelId（即relationId）：非必填，渠道关系ID。适用于渠道推广场景。普通转链不需要本参数

注：【注意】使用渠道ID，务必满足2个要点：

1、使用专属渠道PID或会员专属PID

2、传递relationId参数指定渠道rid

满足以上两个条件后，转链下单，可用订单查询接口指定orderScene=2来查询渠道订单

关于如何通过渠道ID绑定用户以及更多渠道ID使用技巧请戳  点击跳转

5.specialId：非必填，会员运营ID。

注意：当您传了本参数时，请务必使用“会员专属PID”，这样下单时才有透出会员运营ID

6.externalId：非必填，淘宝客外部用户标记，如自身系统账户ID；微信ID等。这个参数是自定义参数值，主要是对开发者自己的新用户首次绑定用。假如您有一个新用户要下单，这时要先调用高佣转链接口，传一个externalId值 dataoke001 （自定义值）

注意：更多externalId参数使用技巧请戳  点击跳转

7.xid：非必填，团长与下游渠道合作的特殊标识。该参数用于统计渠道推广效果

二、返回参数

1、以下五种返回链接都带有您的PID，可以根据不同场景提供给用户使用，用户下单之后即可得到相应的佣金

couponClickUr（商品优惠券推广链接）

tpwd（淘口令）

longTpwd（长口令，针对IOS14版本）

shortUrl（短链接）

kuaiZhanUrl（快站地址，可以再微信里直接打开商品详情）仅支持大淘客商品

2、优惠券面额可以从couponInfo中提取，格式都是固定“满NN元减MM元”，提取出MM元即为优惠券面额

三、使用技巧

1、如何计算预估佣金

调用转链接口一般都是在APP等应用的详情页面，这时需要计算预估佣金：

佣金是根据（券后价*佣金比例）预估的，券后价分3步计算：

① 提取优惠券面额：从优惠券字段 couponInfo 中提取券面额，格式都是固定的“满X元减Y元”，提取Y元就是券面额

② 获取券后价：actualPrice可获取到商品的券后价

③ 计算预估佣金：券后价 * 佣金比例字段（maxCommissionRate）

maxCommissionRate是百分比，如果返回20则表示20%的佣金比例

注：这个是买前预估理想佣金值，实际下单，还要扣除税收、以后可能使用红包导致变低佣等影响，具体参考订单接口

大淘客运营中心

2021年2月4日