package com.snack.server.module.order.service;

import java.util.Map;

/**
 * 支付宝支付服务（电脑网站支付，沙箱）
 */
public interface AlipayService {

    /**
     * 生成电脑网站支付跳转链接
     *
     * @param orderId 订单 ID
     * @return 支付宝支付页面 URL
     */
    String createPagePayUrl(Long orderId);

    /**
     * 处理支付宝支付异步通知
     *
     * @param params 支付宝回调参数
     * @return 支付宝要求返回的 "success" / "fail"
     */
    String handleNotify(Map<String, String> params);

    /**
     * 处理支付宝支付同步返回（验签后跳转前端）
     *
     * @param params 支付宝返回参数
     * @return 前端跳转地址
     */
    String handleReturn(Map<String, String> params);

    /**
     * 处理支付宝退款异步通知
     *
     * @param params 支付宝回调参数
     * @return 支付宝要求返回的 "success" / "fail"
     */
    String handleRefundNotify(Map<String, String> params);
}
