OpenPay Python开发包
python-openpa的Python项目详细描述
python openpay软件开发工具包
创建此模块是为了通过实现付款。Openpay来自任何基于web的平台 由python创建。每个商家都可以使用此sdk为其客户处理订单创建以完成支付。
安装
pip install python-openpay
创建商户
每个merchant对象都是通过使用强制属性jam auth\u token、country\u code和其他两个非强制属性创建的 例如-auth_token和openpay_url_mode如下:-。
fromopenpayimportMerchantmerchant=Merchant(jam_auth_token='your jam auth token',country_code="au or uk"auth_token=None,openpay_url_mode="Live")
这里,openpay url_mode用于指定url的模式,例如“live”或“training”。这是测试此sdk所必需的 以demo或production为目的。
现在merchant可以设置success、cancel和failureURL,以便在付款期间或付款之后通过openpay重定向客户机 如下所示:-
merchant.set_callback_url(callback_url=val1, cancel_url=val2, failure_url=val3)
欺诈变更
如果发生与计划ID对应的欺诈,则商户可以调用以下函数
merchant.online_order_fraud_alert(plan_id=plan_id)
注意:这不是必需的。只有在欺诈发生时才会调用它
一个特定的merchant为他的站点拥有一组clients。因此,当我们创建一个client对象时,我们必须
将merchant对象与其关联。将client与merchant关联的可能方法如下:- 稍后,我们可以使用人口统计信息更新一个client对象,如下所示(res表示住宅地址,del表示送货地址):- 只添加像 创建client的另一种方法,上面两个步骤一起完成,如下所示: 注意:这里 在开始下单之前,需要使用 如果响应状态为true或error为空,则我们可以继续下一个调用 在这里,client将从merchant站点订购一个或多个项目,参数purchase\u price是
项目价格由客户选择。 成功执行后,将为client创建plan id。创建客户端
fromopenpayimportClientclient=Client(merchant=merchant)# association with merchant
client(first_name='openpay',family_name='test',email='testdevloper007@gmail.com',res_address_1='15/520 Collins Street',res_suburb='Melbourne',res_state='Victoria',res_postcode=3000,dob='06 Jan 1985')
del_address_1
这样的del后缀,而不是res_address_1
作为address, suburb and state
。client=Client(first_name='Test',family_name='User',email='testdevloper007@gmail.com',address_1='15/520 Collins Street',suburb='Melbourne',state='Victoria',postcode=3000,dob='06 Jan 1985',merchant=merchant)
%b
month是区域设置的缩写名称。一月,二月,…,十二月。因此,任何有效的date格式都应该是
比如1985年1月6日的06。此外,邮政编码的长度应为4。检查价格是否有效(在最小-最大范围内)
client.is_valid_price(price=<paymentprice>)
new_online_order
在线订单创建
client.new_online_order(purchase_price=<totalprice>,plan_creation_type="Pending")
检查最低和最高购买价格
client.min_max_purchase_price()
< P>此方法用于检查^ {EM1} $ PuraSueSuffyEME>是否在^ {STR 1 } $最小< /强>和^ {STR 1 } $最大< /强>价格范围A
merchant是否。
创建在线计划
plan_link=client.create_online_plan(order_id=<orderIDcreatedfrommerchantsite>)
openpay提供了为这个client支付purchase价格的所有可能计划。一旦client选择了一个计划,那么openpay 重新引导他付款。
检查付款和订单状态
要检查client的付款和订单状态,我们应该分别调用下面的函数和plan\u id作为参数。
client.check_payment_capture(plan_id=plan_id)client.check_order_status(plan_id=plan_id)
创建退款
如果merchant想要为计划创建任何partial退款,那么他必须设置参数plan 新购买价格如下:-
client.refund_status(plan_id=plan_id,new_purchase_price=<revisedpurchaseprice>)
注:参数新购买价格计算如下:-
previous purchase price - amount of price to refund
在full退款的情况下,设置参数plan_id和full_refund,如下所示:-
client.refund_status(plan_id=plan_id,full_return=True)
创建调度
如果merchant想要启动订单的dispatch调度,那么他将使用相应的plan执行方法。 顺序如下:-
client.order_dispatch_plan(plan_id=plan_id)