berlingskemedia/bm.ms.payment_manager

支付管理器微服务

镜像概述和主要用途

Berlingske支付管理器微服务是一个支持MobilePay和Dibs支付网关的支付处理服务，用于处理支付相关业务逻辑，提供支付流程管理、回调处理等核心功能。

核心功能和特性

• 支持MobilePay和Dibs两种支付网关集成
• 提供灵活的环境变量配置，适应不同部署环境（开发、测试、 staging、生产）
• 集成Jest测试框架，支持单元测试和功能测试
• 支持代码覆盖率生成，便于质量监控
• 针对MongoDB集合优化的索引设计，包括TTL索引自动清理过期数据

使用场景和适用范围

适用于需要集成MobilePay和Dibs支付方式的应用系统，作为独立的支付处理微服务组件，处理支付请求、订单管理和支付状态回调等业务。

使用方法和配置说明

Docker环境要求

需要Docker Engine版本17.09.0及以上。

安装

bash
npm install

启动

1. 配置环境变量：使用docker-compose.override.yml设置本地环境变量，可参考docker-compose.override.yml.dist中的示例值
2. 启动应用：

   bash
   # 标准启动
   npm start
   
   # 开发模式（使用nodemon文件监控）
   npm run dev
   

测试

使用Jest进行测试：

运行所有测试

bash
npm t

测试监控模式

bash
npm run test:watch

筛选测试

可直接使用Jest的筛选功能，例如仅运行单元测试：

bash
npm run test -- unit

代码覆盖率

生成HTML格式的代码覆盖率报告：

bash
npm run test:coverage

输出文件位于tests/coverage文件夹。

环境变量配置

基础配置

服务配置

CORS设置

BPC配置

FarPay配置

Gigya配置

购买流程配置

MongoDB索引

actiontoken集合

包含2个索引，其中1个为TTL索引：

javascript
// 唯一索引
await MongoDB.collection('actiontoken').createIndex({ token: 1 }, { unique: true });

// TTL索引（根据PURCHASE_CACHE_TIME自动过期）
await MongoDB.collection('actiontoken').createIndex({ updated: 1 }, { expireAfterSeconds: purchaseConfig.purchaseCacheTime });

orders集合

包含1个TTL索引（30天后自动过期）：

javascript
await MongoDB.collection('orders').createIndex({ changedAt: 1 }, { expireAfterSeconds: 30 * 86400 });