package com.ruoyi.system.service;

import java.math.BigDecimal;
import java.util.Map;

/**
 * 支付模块调用Service接口
 * 
 * @author ruoyi
 * @date 2025-01-15
 */
public interface IPaymentModuleService {
    
    /**
     * 创建支付二维码
     * 
     * @param outTradeNo 商户订单号
     * @param amount 支付金额
     * @param provider 支付提供商(WECHAT/ALIPAY)
     * @param subject 订单标题
     * @param attach 附加数据
     * @param callbackUrl 回调地址
     * @return 支付模块返回结果 {paymentRefId, codeUrl, expireTime}
     */
    Map<String, Object> createQrCode(String outTradeNo, BigDecimal amount, String provider, 
                                     String subject, String attach, String callbackUrl);
    
    /**
     * 查询支付状态
     * 
     * @param paymentRefId 支付模块返回的唯一标识
     * @param outTradeNo 商户订单号
     * @return 支付状态结果 {status, tradeNo, payTime}
     */
    Map<String, Object> queryPaymentStatus(String paymentRefId, String outTradeNo);
}