def refund(self, refund_params):
"""
refund API, refund fee should not be greater than bill total fee;
need_approval is for pre refund, you have to call [audit_pre_refunds] later on to execute real refund
if the bill is paid with ali, you have to input your password on the returned url page
refer to restful API https://beecloud.cn/doc/ #3
:param refund_params: beecloud.entity.BCRefundReqParams
:return: beecloud.entity.BCResult
"""
if self.bc_app.is_test_mode:
return report_not_supported_err('refund')
attach_app_sign(refund_params, BCReqType.REFUND, self.bc_app)
tmp_resp = http_post(self._bill_refund_url(), refund_params, self.bc_app.timeout)
# if err encountered, [0] equals 0
if not tmp_resp[0]:
return tmp_resp[1]
# [1] contains result dict
resp_dict = tmp_resp[1]
bc_result = BCResult()
set_common_attr(resp_dict, bc_result)
if not bc_result.result_code:
bc_result.id = resp_dict.get('id')
# url will be returned if bill is refunded and channel is in (ALI_APP, ALI_WEB, ALI_QRCODE)
bc_result.url = resp_dict.get('url')
return bc_result
def _bill_transfer(self, url, transfer_params):
attach_app_sign(transfer_params, BCReqType.TRANSFER, self.bc_app)
req_dict = {}
for k, v in transfer_params.__dict__.items():
if v:
if k == 'redpack_info': # WX_REDPACK
req_dict[k] = obj_to_dict(v)
elif k == 'transfer_data': # batch_transfer
req_dict[k] = [obj_to_dict(item) for item in transfer_params.transfer_data]
else:
req_dict[k] = v
tmp_resp = http_post(url, req_dict, self.bc_app.timeout)
# if err encountered, [0] equals 0
if not tmp_resp[0]:
return tmp_resp[1]
# [1] contains result dict
resp_dict = tmp_resp[1]
bc_result = BCResult()
set_common_attr(resp_dict, bc_result)
if not bc_result.result_code:
bc_result.id = resp_dict.get('id')
# for ali
bc_result.url = resp_dict.get('url')
return bc_result
def _bill_transfer(self, url, transfer_params):
attach_app_sign(transfer_params, BCReqType.TRANSFER, self.bc_app)
req_dict = {}
for k, v in transfer_params.__dict__.items():
if v:
if k == 'redpack_info': # WX_REDPACK
req_dict[k] = obj_to_dict(v)
elif k == 'transfer_data': # batch_transfer
req_dict[k] = [
obj_to_dict(item)
for item in transfer_params.transfer_data
]
else:
req_dict[k] = v
tmp_resp = http_post(url, req_dict, self.bc_app.timeout)
# if err encountered, [0] equals 0
if not tmp_resp[0]:
return tmp_resp[1]
# [1] contains result dict
resp_dict = tmp_resp[1]
bc_result = BCResult()
set_common_attr(resp_dict, bc_result)
if not bc_result.result_code:
bc_result.id = resp_dict.get('id')
# for ali
bc_result.url = resp_dict.get('url')
return bc_result
def audit_pre_refunds(self, pre_refund_params):
"""
batch manage pre refunds;
pre refund id list is required;
each refund result is kept in result_map
refer to restful API https://beecloud.cn/doc/ #4
:param pre_refund_params: beecloud.entity.BCPreRefundReqParams
:return: beecloud.entity.BCResult
"""
if self.bc_app.is_test_mode:
return report_not_supported_err('audit_pre_refunds')
attach_app_sign(pre_refund_params, BCReqType.PAY, self.bc_app)
tmp_resp = http_put(self._bill_refund_url(), pre_refund_params, self.bc_app.timeout)
# if err encountered, [0] equals 0
if not tmp_resp[0]:
return tmp_resp[1]
# [1] contains result dict
resp_dict = tmp_resp[1]
bc_result = BCResult()
set_common_attr(resp_dict, bc_result)
if not bc_result.result_code:
# if agree is true and refund successfully
bc_result.result_map = resp_dict.get('result_map')
bc_result.url = resp_dict.get('url')
return bc_result
def audit_pre_refunds(self, pre_refund_params):
"""
batch manage pre refunds;
pre refund id list is required;
each refund result is kept in result_map
refer to restful API https://beecloud.cn/doc/?index=rest-api #4
:param pre_refund_params: beecloud.entity.BCPreRefundReqParams
:return: beecloud.entity.BCResult
"""
if self.bc_app.is_test_mode:
return report_not_supported_err('audit_pre_refunds')
attach_app_sign(pre_refund_params, BCReqType.REFUND, self.bc_app)
tmp_resp = http_put(self._bill_refund_url(), pre_refund_params,
self.bc_app.timeout)
# if err encountered, [0] equals 0
if not tmp_resp[0]:
return tmp_resp[1]
# [1] contains result dict
resp_dict = tmp_resp[1]
bc_result = BCResult()
set_common_attr(resp_dict, bc_result)
if not bc_result.result_code:
# if agree is true and refund successfully
bc_result.result_map = resp_dict.get('result_map')
bc_result.url = resp_dict.get('url')
return bc_result
def refund(self, refund_params):
"""
refund API, refund fee should not be greater than bill total fee;
need_approval is for pre refund, you have to call [audit_pre_refunds] later on to execute real refund
if the bill is paid with ali, you have to input your password on the returned url page
refer to restful API https://beecloud.cn/doc/?index=rest-api #3
:param refund_params: beecloud.entity.BCRefundReqParams
:return: beecloud.entity.BCResult
"""
if self.bc_app.is_test_mode:
return report_not_supported_err('refund')
attach_app_sign(refund_params, BCReqType.REFUND, self.bc_app)
tmp_resp = http_post(self._bill_refund_url(), refund_params,
self.bc_app.timeout)
# if err encountered, [0] equals 0
if not tmp_resp[0]:
return tmp_resp[1]
# [1] contains result dict
resp_dict = tmp_resp[1]
bc_result = BCResult()
set_common_attr(resp_dict, bc_result)
if not bc_result.result_code:
bc_result.id = resp_dict.get('id')
# url will be returned if bill is refunded and channel is in (ALI_APP, ALI_WEB, ALI_QRCODE)
bc_result.url = resp_dict.get('url')
return bc_result
def pay(self, pay_params):
"""
payment API, different channels have different requirements for request params
and the return params varies.
refer to restful API https://beecloud.cn/doc/?index=rest-api #2
:param pay_params: beecloud.entity.BCPayReqParams
:return: beecloud.entity.BCResult
"""
self._add_sdk_version(pay_params)
attach_app_sign(pay_params, BCReqType.PAY, self.bc_app)
tmp_resp = http_post(self._bill_pay_url(), pay_params,
self.bc_app.timeout)
# if err encountered, [0] equals 0
if not tmp_resp[0]:
return tmp_resp[1]
# [1] contains result dict
resp_dict = tmp_resp[1]
bc_result = BCResult()
set_common_attr(resp_dict, bc_result)
if not bc_result.result_code:
bc_result.id = resp_dict.get('id')
# most channel will return url or html
if resp_dict.get('html'):
bc_result.html = resp_dict.get('html')
if resp_dict.get('url'):
bc_result.url = resp_dict.get('url')
# WX_NATIVE or BC_NATIVE or BC_ALI_QRCODE
if resp_dict.get('code_url'):
bc_result.code_url = resp_dict.get('code_url')
# WX_JSAPI
if pay_params.channel == BCChannelType.WX_JSAPI:
bc_result.app_id = resp_dict.get('app_id')
bc_result.package = resp_dict.get('package')
bc_result.nonce_str = resp_dict.get('nonce_str')
bc_result.timestamp = resp_dict.get('timestamp')
bc_result.pay_sign = resp_dict.get('pay_sign')
bc_result.sign_type = resp_dict.get('sign_type')
return bc_result
def pay(self, pay_params):
"""
payment API, different channels have different requirements for request params
and the return params varies.
refer to restful API https://beecloud.cn/doc/?index=rest-api #2
:param pay_params: beecloud.entity.BCPayReqParams
:return: beecloud.entity.BCResult
"""
self._add_sdk_version(pay_params)
attach_app_sign(pay_params, BCReqType.PAY, self.bc_app)
tmp_resp = http_post(self._bill_pay_url(), pay_params, self.bc_app.timeout)
# if err encountered, [0] equals 0
if not tmp_resp[0]:
return tmp_resp[1]
# [1] contains result dict
resp_dict = tmp_resp[1]
bc_result = BCResult()
set_common_attr(resp_dict, bc_result)
if not bc_result.result_code:
bc_result.id = resp_dict.get('id')
# most channel will return url or html
if resp_dict.get('html'):
bc_result.html = resp_dict.get('html')
if resp_dict.get('url'):
bc_result.url = resp_dict.get('url')
# WX_NATIVE or BC_NATIVE or BC_ALI_QRCODE
if resp_dict.get('code_url'):
bc_result.code_url = resp_dict.get('code_url')
# WX_JSAPI
if pay_params.channel == BCChannelType.WX_JSAPI:
bc_result.app_id = resp_dict.get('app_id')
bc_result.package = resp_dict.get('package')
bc_result.nonce_str = resp_dict.get('nonce_str')
bc_result.timestamp = resp_dict.get('timestamp')
bc_result.pay_sign = resp_dict.get('pay_sign')
bc_result.sign_type = resp_dict.get('sign_type')
return bc_result
def international_pay(self, pay_params):
"""
international pay -- PayPal
refer to https://github.com/beecloud/beecloud-rest-api/tree/master/international #2
credit_card_info should be type of beecloud.entity.BCPayPalCreditCard
:param pay_params: beecloud.entity.BCInternationalPayParams
:return: beecloud.entity.BCResult
"""
if self.bc_app.is_test_mode:
return report_not_supported_err('international_pay')
attach_app_sign(pay_params, BCReqType.PAY, self.bc_app)
req_dict = {}
for k, v in pay_params.__dict__.items():
if v:
if k == 'credit_card_info':
req_dict[k] = obj_to_dict(v)
else:
req_dict[k] = v
tmp_resp = http_post(self._international_pay_url(), req_dict,
self.bc_app.timeout)
# if err encountered, [0] equals 0
if not tmp_resp[0]:
return tmp_resp[1]
# [1] contains result dict
resp_dict = tmp_resp[1]
bc_result = BCResult()
set_common_attr(resp_dict, bc_result)
if not bc_result.result_code:
bc_result.id = resp_dict.get('id')
# url is returned when channel is PAYPAL_PAYPAL
bc_result.url = resp_dict.get('url')
# credit_card_id is returned when channel is PAYPAL_CREDITCARD
bc_result.credit_card_id = resp_dict.get('credit_card_id')
return bc_result
def international_pay(self, pay_params):
"""
international pay -- PayPal
refer to https://github.com/beecloud/beecloud-rest-api/tree/master/international #2
credit_card_info should be type of beecloud.entity.BCPayPalCreditCard
:param pay_params: beecloud.entity.BCInternationalPayParams
:return: beecloud.entity.BCResult
"""
if self.bc_app.is_test_mode:
return report_not_supported_err('international_pay')
attach_app_sign(pay_params, BCReqType.PAY, self.bc_app)
req_dict = {}
for k, v in pay_params.__dict__.items():
if v:
if k == 'credit_card_info':
req_dict[k] = obj_to_dict(v)
else:
req_dict[k] = v
tmp_resp = http_post(self._international_pay_url(), req_dict, self.bc_app.timeout)
# if err encountered, [0] equals 0
if not tmp_resp[0]:
return tmp_resp[1]
# [1] contains result dict
resp_dict = tmp_resp[1]
bc_result = BCResult()
set_common_attr(resp_dict, bc_result)
if not bc_result.result_code:
bc_result.id = resp_dict.get('id')
# url is returned when channel is PAYPAL_PAYPAL
bc_result.url = resp_dict.get('url')
# credit_card_id is returned when channel is PAYPAL_CREDITCARD
bc_result.credit_card_id = resp_dict.get('credit_card_id')
return bc_result