取消支付接口

目录

1. 功能说明

退款。扣费成功,发货失败后,必须调用本接口。如果不调默认将进行扣费确认。
移动端的应用,按照游戏币的充值数量进行结算,每月结算时依据当月玩家游戏币的充值总量进行分成。

2. 调用说明

2.1 URL地址

【现网】https://openapi.tencentyun.com/mpay/cancel_pay_m
【沙箱】http://119.147.19.43/mpay/cancel_pay_m

2.2 请求参数

Cookie里面需要包含的参数:
参数名 参数说明
session_id 用户账户类型,session_id =“openid”(固定传“openid”,不是传openid值)
session_type session类型,session_type = “kp_actoken”(固定传”kp_actoken”,不是传kp_actoken值)
org_loc 需要填写: /mpay/cancel_pay_m
appip (可选)来源的第三方应用的服务IP

注意:cookie里面参数的值,需要进行urlencode


请求参数:
参数名 参数说明
openid 从手Q登录态中获取的openid的值
openkey 从手Q登录态中获取的access_token 的值
pay_token 从手Q登录态中获取的pay_token的值
appid 应用的唯一ID。可以通过appid查找APP基本信息。这个appid在数值上和支付ID也就是客户端设置的offerid是相同的
ts UNIX时间戳(从格林威治时间1970年01月01日00时00分00秒起至现在的总秒数)。
sig 请求串的签名(可以参考下面具体示例,或者到wiki下载SDK)。
pf 平台来源,平台-注册渠道-系统运行平台-安装渠道-业务自定义。

例如: qq_m_qq-10000144-android-10000144-xxxx
qq_m_qq 表示 手Q平台启动,用qq登录态

zoneid 账户分区ID_角色。和PC接入时保持一致,分区可以在open.qq.com上自助配置。如过应用选择支持角色,则角色接在分区ID号后用"_"连接,角色需要进行urlencode。

注意:如果游戏PC端和移动端是游戏币互通模式,zoneid 的数值保持和PC侧接入支付时传递的一致。例如,游戏A在PC上运行是接入过支付,PC上有分区0和分区1,再接入移动支付是要求移动端账户和PC端账户互通,那么接入移动支付时,zoneid根据需要由业务自己传递PC上配置的分区ID,对0分区操作就传0,对1分区操作就传1

amt 扣游戏币数量。
billno 预扣流水号。
pfkey 登录时候跳转到应用首页后,URL后会带该参数。由平台直接传给应用,应用原样传给平台即可。
userip (可选)用户的外网IP
accounttype (可选)帐户类型ID, 基础货币(common) 安全货币(security), 不填默认common
format (可选)json、jsonp_$func。默认json。如果jsonp,前缀为:$func

例如:format=jsonp_sample_pay,返回格式前缀为:sample_pay()

2.3 请求示例

示例:(仅演示sig生成使用)
appkey:56abfbcd12fe46f5ad85ad9f12345678&
method:GET
url_path: /mpay/cancel_pay_m

amt:10
appid:15499
billno:250000528
openid:00000000000000000000000014BDF6E4
openkey:AB43BF3DC5C3C79D358CC5318E41CF59
pf:qzone
pfkey:CA641BC173479B8C0B35BC84873B3DB9
ts:1340880012
userip:112.90.139.30

把参数按规则排序后组装:
GET&%2Fmpay%2Fcancel_pay_m&amt%3D10%26appid%3D15499%26billno%3D250000528%26openid%3D000 00000000000000000000014BDF6E4%26openkey%3DAB43BF3DC5C3C79D358CC5318E41CF59%26pf%3Dqzone %26pfkey%3DCA641BC173479B8C0B35BC84873B3DB9%26ts%3D1340880012%26userip%3D112.90.139.30

sha1后得到签名sig:
sig=zFpEuKVX71yzuKS25ZbRvH7QanI%3D

得到最终的请求串:
http://119.147.19.43/mpay/cancel_pay_m?amt=10&appid=15499&billno=2500 00528&openid=00000000000000000000000014BDF6E4&openkey=AB43BF3DC5C3C79D358CC5318E41CF59 &pf=qzone&pfkey=CA641BC173479B8C0B35BC84873B3DB9&ts=1340880012&userip=112.90.139.30&si g=zFpEuKVX71yzuKS25ZbRvH7QanI%3D

2.4 返回参数说明

示例:

ret 返回码
0 成功
1018 登陆校验失败
其它 失败

2.5 返回示例

正确返回示例

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

错误返回示例

Content-type: text/html; charset=utf-8
{"ret":1018,"msg":"请先登录"}

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

Copyright © 1998 - 2017 Tencent. All Rights Reserved.

腾讯公司 版权所有

有问必答 返回顶部