Python版SDK

第一步:创建应用及相关权限申请

请先阅读快速接入模块,开展相关环节。

第二步:下载SDK

开发语言资源下载环境要求
PythonSDK适用于Python3语言开发环境

第三步:集成SDK应用开发

SDK相关接口调用

注意: 在调用SDK的文件管理相关接口前,需要先配置SDK的应用信息:

  1. def set_config(cls, appid, appkey)

参数说明

参数参数类型说明
appidstring应用唯一标识
appkeystring应用秘钥

调用方式:Config.set_config(appid, appkey)

SDK接口说明如下:

1, 判断用户是否有相关权益2, 预下单接口3, 使用用户自身权益4, 零售下单

1, 判断用户是否有相关权益

  1. def get_usable_service(cls, access_token, openid, service_id, total_num)

参数说明

参数参数类型说明
access_tokenstringaccess_token
openidstring用户标识openid
service_idstring服务id,开发者对接后可用的服务
total_numint64查询数量,仅消耗类型的服务需要传对应的数量,其他的传0

调用方式:has_usable = Payment.get_usable_service(access_token, openid, service_id, total_num)

2, 预下单接口

  1. def preorder_pay(cls, access_token, openid, service_id, total_num, billno, subject, csource, client_ip)

参数说明

参数参数类型说明
access_tokenstringaccess_token
openidstring用户标识openid
service_idstring服务id,开发者对接后可用的服务
total_numint64查询数量,仅消耗类型的服务需要传对应的数量,其他的传0
billnostring合作方自己的订单号,需要合作方每次下单时保证唯一未使用的订单号,长度不超过32位字符
subjectstring购买内容,当服务类型为第三方自己的服务时传对应的服务id
csourcestring购买来源
client_ipstring客户端IP,由接入方获取客户端ip后传过来

调用方式:billno = Payment.preorder_pay(access_token, openid, service_id, total_num, billno, subject, csource, client_ip)

3, 使用用户自身权益

  1. def use_service(cls, access_token, openid, service_id, total_num, billno)

参数说明

参数参数类型说明
access_tokenstringrequiredaccess_token
openidstringrequired用户标识openid
service_idstringrequired服务id,开发者对接后可用的服务
total_numint64required查询数量,仅消耗类型的服务需要传对应的数量,其他的传0
billnostringrequired合作方自己的订单号,需要合作方每次下单时保证唯一未使用的订单号,长度不超过32位字符

调用方式:is_use_service = Payment.use_service(access_token, openid, service_id, total_num, billno)

4, 零售下单

  1. def custom_order_pay(cls, access_token, billno, openid, payment, service_id, subject, csource, total_fee, count)

参数说明

参数参数类型说明
access_tokenstringaccess_token
billnostring合作方自己的订单号,需要合作方每次下单时保证唯一未使用的订单号,长度不超过32位字符
openidstring用户标识openid
paymentstring支付方式,目前只支持 qrcode: 二维码支付 ios: ios支付 (预下单) android_wechat: 安卓微信支付 (预下单) android_alipay: 安卓支付宝支付 (预下单)
service_idstring服务id,开发者对接后可用的服务
subjectstring购买内容,当服务类型为第三方自己的服务时传对应的服务id
csourcestring购买来源
total_feeint64订单金额(单位: 分)
countint64购买数量

调用方式:billno = Payment.custom_order_pay(access_token, billno, openid, payment, service_id, subject, csource, total_fee, count)

有任何疑问,请加入QQ群: 732130805 或者联系open@wps.cn获取帮助。