payment

type CallbackContext struct {
	RawBody []byte      // 原始请求体
	Headers http.Header // 请求头（验签常用）
	Query   url.Values  // 查询参数（部分网关把结果放这里）
	Config  string      // 网关配置 JSON（含密钥等），由调用方从 DB 读取
}

type CallbackResult struct {
	TradeNo        string // 商户订单号
	GatewayTradeNo string // 第三方订单号
	Amount         *float64
	Status         string // paid / failed / pending
	Raw            string // 原始回调数据，落库备查
}

type Gateway interface {
	// Type 返回网关类型标识（如 "epay"、"alipay"），与路由 :type 对应。
	Type() string
	// VerifyCallback 校验回调真实性并解析出标准化结果。
	// 验签失败必须返回 error，调用方据此拒绝（fail-closed）。
	VerifyCallback(ctx *CallbackContext) (*CallbackResult, error)
}