移动订货在线支付插件概要说明

    移动订货在线支付功能是提供给门店订货人员在移动订货App上进行在线实时支付的一个便捷功能。产品现已支持微信h5支付、支付宝支付、微信公众号支付、微信小程序支付。客户在使用中如有其他的第三方支付需求，可参考以下说明进行扩展。

一、创建一个移动订货在线支付插件

1. 创建移动订货在线支付插件类库

使用VS2012及以上版本的C#语言，创建一个Class Library项目：

2. 引用必要组件

到K/3 Cloud安装目录的WebSite\Bin子目录，引用如下组件：

Kingdee.BOS.dll

Kingdee.BOS.DataEntity.dll

Kingdee.K3.DE.Mobile.Common.Core.dll

Kingdee.K3.DE.SCM.Common.BusinessEntity.dll

Kingdee.K3.DE.SCM.Common.Core.dll

Kingdee.K3.DE.SCM.App.Core.dll

3. 创建移动订货在线支付插件类

在前文所建的移动订货在线支付插件工程中，添加新类，派生自移动订货在线支付基类：Kingdee.K3.DE.SCM.App.Core.OnlinePay.AbstractPay，编译部署该插件工程到金蝶云星空应用服务器中。

支付基类：

二、启用移动订货在线支付插件

1. 新建对应结算方式并配置自定义插件类

登录系统，打开【基础管理-基础资料-财务会计-结算方式】菜单，新增结算方式

2. 配置门店移动订货支付方式

登录系统，打开【餐饮门店管理-门店订货管理-基础资料-门店移动订货支付方式】菜单，新增门店移动订货支付方式

3. 配置总部收款账户信息

登录系统，打开【餐饮门店管理-门店订货管理-基础资料-总部收款账户】菜单，新增总部收款账户

4. 配置支付结果通知接口

前置补丁要求： PT-001846 [Kingdee Cloud CY V7 SP.8.0.1114.1]

打开配置文件\K3Cloud\WebSite\App_Data\ Common.config

在appSettings节点下增加以下节点：

<add key="回调地址" value="支付插件（类的全限定名+英文逗号+程序集名）" />

提供给支付系统的支付结果通知接口：

http://cloud服务器域名/K3Cloud/回调地址/mobile.cymcbapi

注：上述两个回调地址的大小写必须保持一致

示例：

<appSettings>

<add key="KDPayCallBack" value="Kingdee.K3.DE.SCM.App.Core.OnlinePay.BaseKDPay, Kingdee.K3.DE.SCM.App.Core" />

</appSettings>

提供给支付系统的支付结果通知接口：

http://www.kingdee.com/ K3Cloud/KDPayCallBack/mobile.cymcbapi

三、插件基类的虚方法说明

1. Pay

移动订货在线支付方法，在该方法内调用支付平台接口进行支付下单操作，支付平台处理后返回跳转URL给前端，前端得到URL后跳转到支付平台进行支付。

虚方法定义：

public virtual PayResult Pay(Context ctx, PayParameter payParm, HttpContext httpContext)

2. QueryOrder

查询订单方法，主动查询订单状态。此方法通常提供给前端在支付完成后进行订单状态的查询操作。

虚方法定义：

public virtual QueryOrderResult QueryOrder(Context ctx, QueryOrderParameter queryParm, HttpContext httpContext)

3. Refund

退款申请方法，可以继承该方法实现将支付金额退还给买家，一般支付平台在收到退款请求并且验证成功之后，将支付款按原路退还至买家帐号上。

虚方法定义：

public virtual RefundResult Refund(Context ctx, RefundParameter refundParm, HttpContext httpContext)

4. QueryRefund

提交退款申请后，可以通过继承该方法实现查询退款状态。

虚方法定义：

public virtual QueryRefundResult QueryRefund(Context ctx, QueryRefundParameter queryParm, HttpContext httpContext)

5. PayCallBackParseData

支付系统调用支付结果通知接口后，需要经过解密请求数据、处理系统单据、响应请求这三个步骤。通过继承该方法，实现对请求数据的解密。

虚方法定义：

public virtual PayCallBackParseResult PayCallBackParseData(HttpContext httpContext)