openmf/ph-ee-notifications

支付通知处理Docker镜像

概述

本Docker镜像专为支付通知处理设计，旨在简化支付流程中的通知管理环节。通过集成多支付平台的通知处理逻辑，提供标准化的通知接收、解析和转发能力，帮助开发者快速构建稳定可靠的支付通知处理系统。

核心功能与特性

• 多支付平台支持：内置***、***、***等主流支付平台的通知格式解析逻辑，无需单独开发适配代码
• 自动通知验证：支持对支付平台发送的通知进行签名验证，确保通知的合法性和完整性
• 通知转发机制：可将处理后的通知数据转发至指定的业务系统或消息队列（如HTTP端点、Kafka等）
• 日志与监控：提供详细的通知处理日志，支持集成Prometheus等监控工具
• 高可用性：支持水平扩展，可通过负载均衡提高通知处理能力

使用场景

• 电商平台：统一处理来自不同支付方式的订单支付结果通知
• 支付服务提供商：为商户提供标准化的支付通知处理解决方案
• 企业财务系统：接收并处理各类在线支付的到账通知，自动更新财务记录
• SaaS应用：集成至第三方应用中，提供内置的支付通知处理能力

使用方法

快速启动

使用以下命令启动容器：

bash
docker run -d \
  --name payment-notifications \
  -p 8080:8080 \
  -e PORT=8080 \
  -e SUPPORTED_GATEWAYS=alipay,wechatpay,paypal \
  -e ALIPAY_APP_SECRET=your_alipay_secret \
  -e WECHATPAY_API_KEY=your_wechat_key \
  -e PAYPAL_CLIENT_SECRET=your_paypal_secret \
  -e FORWARD_ENDPOINT=http://your-backend/service/notify \
  -e LOG_LEVEL=info \
  payment-notifications:latest

环境变量配置

配置支付网关

针对不同支付平台，需配置对应的密钥信息：

通知接收端点

容器启动后，可通过以下端点接收支付通知：

• ***：http://<container-ip>:<port>/notify/alipay
• ***：http://<container-ip>:<port>/notify/wechatpay
• ***：http://<container-ip>:<port>/notify/paypal

Docker Compose配置示例

yaml
version: '3'
services:
  payment-notifications:
    image: payment-notifications:latest
    ports:
      - "8080:8080"
    environment:
      - PORT=8080
      - SUPPORTED_GATEWAYS=alipay,wechatpay
      - ALIPAY_APP_SECRET=${ALIPAY_SECRET}
      - WECHATPAY_API_KEY=${WECHAT_KEY}
      - FORWARD_ENDPOINT=http://backend-service:3000/api/handle-notify
      - LOG_LEVEL=info
    volumes:
      - ./logs:/app/logs
    restart: always

数据持久化

如需持久化存储通知日志，可挂载日志目录：

bash
docker run -d \
  -v /host/path/to/logs:/app/logs \
  ...(其他参数)...
  payment-notifications:latest

扩展配置

通过挂载自定义配置文件实现高级功能：

bash
docker run -d \
  -v /host/path/to/config.yaml:/app/config.yaml \
  ...(其他参数)...
  payment-notifications:latest

配置文件支持自定义通知处理规则、重试策略等高级设置。