v3/pay/inform_task_completed

特别声明
1.本接口仅针对已经接入支付,且已上线QQ空间的应用使用。
2.本接口用于实现交叉推广任务集市V2版本买方应用开发说明中的Step3;买方通知平台用户已完成任务,详见这里

目录

1 功能说明

交叉推广任务集市V2版本中,用户完成买方在任务集市投放的任务后,买方应用调用本接口通知平台用户已完成任务。

本接口属于整体流程中的第3步:
cross_spread_v2_12.png

2 接口调用说明

2.1 URL

https://[域名]/v3/pay/inform_task_completed

正式环境域名或测试环境IP详见:API3.0文档#请求URL说明
注意:本接口需要使用HTTPS协议访问。

2.2 格式

json

2.3 HTTP请求方式

GET, POST

2.4 IP限制

TRUE

2.5 输入参数说明

各个参数请进行URL 编码,编码时请遵守 RFC 1738

(1)公共参数
发送请求时必须传入公共参数,详见公共参数说明

(2)私有参数

参数名称 是否必须 类型 描述
pfkey 必须 string 跳转到应用首页后,URL后会带该参数。由平台直接传给应用,应用原样传给平台即可。

表示平台的信息加密串,根据openid,openkey,pf,appid等生成。
注:有的应用调用本接口时会返回pfkey非法的错误,这种错误可能由以下原因引起:
(1)传入的pf与平台不一致(例如进入的平台是Qzone,但传入的pf是pengyou),导致生成的pfkey错误。
pf值是由平台直接传给应用,应用原样传给平台即可,出现这种错误的原因是开发者自己手动构造的pf值,而不是使用平台传递的值。
(2)传入的openkey不是当前页面返回的openkey。同一个用户如果在不同时间打开多个应用页面,页面返回的openkey是不一样的,这些openkey在各自的页面都可用。当前页面的pfkey应该使用当前页面的openkey来生成。

ts 必须 string linux时间戳。

注意开发者的机器时间与腾讯计费开放平台的时间相差不能超过15分钟。

inform_type 必须 string 固定值:1。表示用户完成买方应用自定义任务。
contractid 必须 string 任务ID,即买方应用在管理中心发布任务成功后获得的ID。
zoneid string 表示多区多服应用某一个大区的ID号;如果是单区单服应用,则这里传0。

(原来已上线支付的的单区单服应用zoneid可以不传值,系统默认为0;自2012年8月16日起,所有新接入支付的应用都必须传zoneid)。

SerialNo string 序列号,用来标识一次完整的用户操作流程。

2.6 请求示例

本接口的签名生成较为复杂,许多应用在此出错,因此下面演示了sig签名的生成细节。开发者可以下面的示例来验证sig的计算方法,但不能直接复制。

method:GET
url_path:/v3/pay/inform_task_completed
假设appkey为: 56abfbcd12fe46f5ad85ad9f2faf36d7


请求参数包括:
appid:15499
contractid:123
openid:00000000000000000000000014BDF6E4
openkey:803C46E09AACA641351D7121C4746FC3
pf:qzone
pfkey:E9B3FD70C7C2479BCA51E3847A645E83
ts:1349955297
zoneid:


则生成sig时构造的源串为: GET&%2Fv3%2Fpay%2Finform_task_completed&appid%3D15499%26contractid%3D123%26
openid%3D00000000000000000000000014BDF6E4%26openkey%3D803C46E09AACA641351D7121C4746FC3%26pf%3Dqzone%26
pfkey%3DE9B3FD70C7C2479BCA51E3847A645E83%26ts%3D1349955297%26zoneid%3D


生成sig时构造的密钥为:56abfbcd12fe46f5ad85ad9f2faf36d7&


生成的签名为: ThBMGGPFG/n18E3sQA/GeSEoGmA=


URL编码前的请求:https://119.147.19.43/v3/pay/inform_task_completed?appid=15499&contractid=123&
openid=00000000000000000000000014BDF6E4&openkey=803C46E09AACA641351D7121C4746FC3&pf=qzone&
pfkey=E9B3FD70C7C2479BCA51E3847A645E83&ts=1349955297&zoneid=&sig=ThBMGGPFG/n18E3sQA/GeSEoGmA=


URL编码后的请求:https://119.147.19.43/v3/pay/inform_task_completed?appid=15499&contractid=123&
openid=00000000000000000000000014BDF6E4&openkey=803C46E09AACA641351D7121C4746FC3&pf=qzone&
pfkey=E9B3FD70C7C2479BCA51E3847A645E83&ts=1349955297&zoneid=&sig=ThBMGGPFG%2Fn18E3sQA%2FGeSEoGmA%3D


2.7 返回参数说明

参数名称 描述
ret 返回码。

私有返回码说明如下:
1000:请求参数错误。
公共返回码详见公共返回码说明#OpenAPI V3.0 返回码

msg 如果错误,返回错误信息。
is_lost 判断是否有数据丢失。如果应用不使用cache,不需要关心此参数。

0或者不返回:没有数据丢失,可以缓存。
1:有部分数据丢失或错误,不要缓存。

2.8 正确返回示例

JSON示例:

Content-type: text/html; charset=utf-8
{
  "ret":0,
  "msg":"success",   
  "is_lost":"0"
} 

2.9 错误返回示例

Content-type: text/html; charset=utf-8
{
  "ret":1000,
  "msg":"参数错误(contractid)" 
}

相关文档

下一步:回调任务完成通知协议说明

其他相关文档:交叉推广渠道简介_V2 | 交叉推广常见问题

以上信息是否解决您的问题?

Copyright © 1998 - 2017 Tencent. All Rights Reserved.

腾讯公司 版权所有

有问必答 返回顶部