# finance-pay - 财务-支付相关

> 支付配置，支付通道，财务，账单，快递相关功能、模块、项目、服务简易说明

# 🌟 核心功能

## 支付
>**解释：**
>> **支付通道** ：每个支付平台的配置比如银商，对接了青岛，武汉，杭州 3家; 每家的配置不同，且同一配置可支持不同的类型支付【支付宝，微信，网页，云闪付，银行卡，收银台等】；
> 所以对每家的配置设置一个唯一的标识。\
> 比如：银商【青岛】-支付宝【小程序|app】
> 对此规则进行编码 <font color=red>alipay-applet-qm 【alipay-applet：支付宝小程序|app】 qm【第一版表示：全民（后续改成银商，同一家公司）】</font>然后根据此编码查询数据库生成的最大编码
> 进行<font color=red> +1 </font>，最终生成支付通道唯一标识【<font color=red>alipay-applet-qm1</font>】 
>

### 支付配置 [admin服务]
>  多支付平台的配置管理，包含:支付通道配置，支付接口参数，支付分配规则配置等 \
>  支付相关功能 [poyee-pay](../poyee-pay/README.md) 
>>  部分管理功能迁移到 项目 [auction-order\poyee-pay](http://git.hobbystocks.cn/poyee/auction-order.git) \
>>  git地址：[http://git.hobbystocks.cn/poyee/auction-order.git](http://git.hobbystocks.cn/poyee/auction-order.git) 

- **后台管理**
  - 页面路径： 授权 > 支付管理
  - 功能:
    - 新增，编辑，管理支付通道配置 

### 支付配置 [app服务]

> app 服务 根据字典表配置获取可用的支付平台，同时兼容用户个人的标签进行特殊处理 \
> 获取可用支付通道列表， 可用银行卡列表【宝付快捷、协议支付】等需要调用服务 [auction-order\poyee-pay](http://git.hobbystocks.cn/poyee/auction-order.git) 接口\ 
> 获取支付参数需要调用服务 [auction-order\poyee-pay](http://git.hobbystocks.cn/poyee/auction-order.git) 接口 \
> 退款时发送mq 到 admin 服务处理 ,经过 admin 调用服务 [auction-order\poyee-pay](http://git.hobbystocks.cn/poyee/auction-order.git) 退款接口
>> key <font color=red>QUEUE_ASYNC_REFUND</font>
>

### 支付配置 [auction-order/poyee-pay 服务]
> [MD说明](https://git.hobbystocks.cn/poyee/auction-order/src/dev/poyee-pay) \
> 支付配置的主要业务处理\
> 通过此服务与第三方支付公司 [银商，支付宝，微信，宝付等支付平台] 进行交互 \
> 部分管理功能已迁移至此【admin 后台的支付管理功能 (增改查)】\
> 后续接入新支付公司时，可参考此服务进行开发 \
> 支付回调模块也在此服务: 支付|退款回调 可通过 mq ,http 发送到对应的业务处理服务 \
> 此服务只处理支付相关，业务不进行处理
- mq key
  - 支付：[主要业务]
    - 交换机key: [ROUTING_KEY_PRE_CALLBACK] 
    - routingKey: [ROUTING_KEY_PRE_CALLBACK] 
  - 退款：[主要业务]
    - 交换机key: [EXCHANGE_PRE_REFUND_CALLBACK]
    - routingKey: [ROUTING_KEY_PRE_REFUND_CALLBACK] 

## 财务服务【py-finance】
> admin 首页统计，商家打款导出等功能 \
> 经过admin 服务调用 \
> [poyee-finance](http://git.hobbystocks.cn/poyee/py-finance.git) 
>

## 账单
> 账单管理主要在 admin 服务中处理 \
> 主要相关模块：
>> [poyee-finanace](README.md)
> 包含：快递账单，精美卡片账单，商城提现申请，打款账单，服务费开票管理等

## 快递
> 快递管理主要为对接快递物流公司，为商家提供物流功能【一键发货，打单，查询，物流轨迹】，扩展业务【支付快递费用等】\
> **主要用到模块**：
>> admin : 一键发货，获取面单(定时任务)，打单， 获取物流轨迹，获取费用明细(定时任务) ，取消订单\
> app : 一键发货，打单，获取物流轨迹, 取消订单, 支付快递费用\
> auction-order/poyee-order: 对接物流公司：下单，取消订单，获取物流轨迹，获取费用明细等