Python 支付整合开发包的实现
轻量级支付方式整合集成,实现支付与业务完全剥离,快速简单完成支付模块的开发
特性
- 屏蔽支付方式之间接入API和数据结构的差异,统一API和数据结构
- 支持支付类型横向扩展
- 统一异常处理
支持支付方式及功能
支付方式
- pay_type=ali_pay
- pay_type=wx_pay
通用功能
- 电脑网站支付
- 手机网站支付
- APP支付
- 异步通知校验
- 交易查询
- 交易取消
- 退款
- 退款查询
平台特有功能
- 微信JS支付
- 微信企业付款到零钱
使用说明
安装
#installation pipinstallall-pay--upgrade
核心说明
配置(dict)
ALIPAY_CONFIG={ 'pay_type':'ali_pay',#必填区分支付类型 'app_id':'xxx',#必填应用id 'private_key_path':'xxx',#必填私钥 'public_key_path':'xxx',#必填公钥 'notify_url':'xxx',#异步回调地址 'sign_type':'RSA2',#签名算法RSA或者RSA2 'debug':False,#是否是沙箱模式 } WECHAT_CONFIG={ 'pay_type':'wx_pay',#必填区分支付类型 'app_id':'xxx',#必填,应用id 'mch_key':'xxx',#必填,商户平台密钥 'mch_id':'xxx',#必填,微信支付分配的商户号 'app_secret':'xxx',#应用密钥 'notify_url':'xxx'#异步回调地址 'api_cert_path':'xxx',#API证书 'api_key_path':'xxx'#API证书key }
其中pay_type为本项目所需,用来区分支付类型,其余为对应支付方式所需配置参数,具体参考对应支付方式对应的官方文档。
Pay类
支付网关,支付方式分配和转发入口
PayOrder类
统一封装支付订单信息,主要用于支付下单
生成统一订单例子
order=PayOrder.Builder().subject('商品标题').out_trade_no('商品订单号').total_fee('商品费用').build()
通过Builder模式+链式调用灵活组合通用参数和特殊参数更多参数说明参见源码
PayResponse类
统一封装支付返回业务信息,主要用于支付查询
生成统一回单例子
response=PayResponse.Builder().trade_no('平台订单号').out_trade_no('商家订单号').build()
通过Builder模式+链式调用灵活组合通用参数和特殊参数更多参数说明参见源码
demo
fromall_payimportPayOrder fromall_payimportPay ALIPAY_CONFIG={ 'pay_type':'ali_pay',#必填区分支付类型 'app_id':'xxx',#必填应用id 'private_key_path':'xxx',#必填私钥 'public_key_path':'xxx',#必填公钥 'notify_url':'xxx',#异步回调地址 'sign_type':'RSA2',#签名算法RSA或者RSA2 'debug':False,#是否是沙箱模式 } #额外参数,某些支付方式有些选填的参数在PayOrder并没有封装,可以自行传递 extra_params={ 'xxx':'xxx' 'xxx':'xxx' 'xxx':'xxx' } order=PayOrder.Builder().subject('商品标题').out_trade_no('商品订单号').total_fee('商品费用').build() pay=Pay(ALIPAY_CONFIG)#传入对应支付方式配置 order_res=pay.trade_page_pay(order,extra_params)#传入对应订单和额外参数(要是需要)
功能说明
电脑网站支付[trade_page_pay]
pay=Pay(ALIPAY_CONFIG)#传入对应支付方式配置 order_res=pay.trade_page_pay(order)#传入对应订单
手机网站支付[trade_wap_pay]
pay=Pay(ALIPAY_CONFIG)#传入对应支付方式配置 order_res=pay.trade_wap_pay(order)#传入对应订单
APP支付[trade_app_pay]
pay=Pay(ALIPAY_CONFIG)#传入对应支付方式配置 order_res=pay.trade_app_pay(order)#传入对应订单
异步通知校验[parse_and_verify_result]
#传入对应支付方式配置 pay=Pay(WECHAT_CONFIG) #传入对应支付方式返回的原始数据,校验成功会返回解析成json数据 data=pay.parse_and_verify_result(req_xml)
微信JS支付[trade_js_pay]
#传入对应支付方式配置 pay=Pay(WECHAT_CONFIG) #传入对应订单 data=pay.trade_js_pay(order)
微信企业付款到零钱[enterprise_pay]
#传入对应支付方式配置 pay=Pay(WECHAT_CONFIG) #传入对应订单 data=pay.enterprise_pay(order)
交易查询[trade_query]
#传入对应支付方式配置 pay=Pay(WECHAT_CONFIG) #传入对应回单信息 data=pay.trade_query(response)
交易取消[trade_cancel]
#传入对应支付方式配置 pay=Pay(WECHAT_CONFIG) #传入对应回单信息 data=pay.trade_cancel(response)
退款[trade_refund]
#传入对应支付方式配置 pay=Pay(WECHAT_CONFIG) #传入对应回单信息 data=pay.trade_refund(response)
退款查询[trade_refund_query]
#传入对应支付方式配置 pay=Pay(WECHAT_CONFIG) #传入对应回单信息 data=pay.trade_refund_query(response)
贡献
本项目目前支持的支付方式和API还不多,欢迎你给本项目提pullrequest,扩展新的的支付接口,同时如果你有好的意见或建议,也欢迎给本项目提issue
声明:本项目主要目标的是支付整合,统一支付API和数据结构,在具体支付模块的接入实现参考了一些开源项目
支付宝模块基于python-alipay-sdk
微信模块基于wx_pay_python
以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持毛票票。