🎨 新增支付动态配置&优化支付回调&新增三方支付

utils/pay/request/request.go

@@ -0,0 +1,159 @@
+// Package request 神奇支付SDK请求结构体
+package request
+
+// CreateOrder 统一下单请求
+type CreateOrder struct {
+	// Method 接口类型(必填)
+	// 可选值: web(通用网页支付) / jump(跳转支付) / jsapi(JSAPI支付) / app(APP支付) / scan(付款码支付) / applet(小程序支付)
+	Method string
+
+	// Device 设备类型(仅web需要)
+	// 可选值: pc(电脑浏览器) / mobile(手机浏览器) / qq(QQ浏览器) / wechat(微信浏览器) / alipay(支付宝客户端)
+	Device string
+
+	// Type 支付方式(必填)
+	// 可选值: alipay(支付宝) / wxpay(微信支付) / qqpay(QQ钱包)
+	Type string
+
+	// OutTradeNo 商户订单号(必填)
+	OutTradeNo string
+
+	// NotifyURL 异步通知地址(必填)
+	NotifyURL string
+
+	// ReturnURL 跳转通知地址(必填)
+	ReturnURL string
+
+	// Name 商品名称(必填)，超过127字节会自动截取
+	Name string
+
+	// Money 商品金额(必填)，单位：元，最大2位小数
+	Money string
+
+	// ClientIP 用户IP地址(必填)
+	ClientIP string
+
+	// Param 业务扩展参数(可选)，支付后原样返回
+	Param string
+
+	// AuthCode 被扫支付授权码(scan模式需要)
+	AuthCode string
+
+	// SubOpenid 用户Openid(jsapi需要)
+	SubOpenid string
+
+	// SubAppid 公众号/小程序AppId(jsapi需要)
+	SubAppid string
+
+	// ChannelID 自定义通道ID(可选)，对应进件商户列表的ID
+	ChannelID int
+}
+
+// SubmitOrder 页面跳转支付请求(用于构建URL)
+type SubmitOrder struct {
+	// Type 支付方式，不传会跳转到收银台
+	// 可选值: alipay(支付宝) / wxpay(微信支付) / qqpay(QQ钱包)
+	Type string
+
+	// OutTradeNo 商户订单号(必填)
+	OutTradeNo string
+
+	// NotifyURL 异步通知地址(必填)
+	NotifyURL string
+
+	// ReturnURL 跳转通知地址(必填)
+	ReturnURL string
+
+	// Name 商品名称(必填)
+	Name string
+
+	// Money 商品金额(必填)，单位：元
+	Money string
+
+	// Param 业务扩展参数(可选)
+	Param string
+
+	// ChannelID 自定义通道ID(可选)
+	ChannelID int
+}
+
+// QueryOrder 订单查询请求
+type QueryOrder struct {
+	// TradeNo 平台订单号(与商户订单号二选一)
+	TradeNo string
+
+	// OutTradeNo 商户订单号(与平台订单号二选一)
+	OutTradeNo string
+}
+
+// Refund 订单退款请求
+type Refund struct {
+	// TradeNo 平台订单号(与商户订单号二选一)
+	TradeNo string
+
+	// OutTradeNo 商户订单号(与平台订单号二选一)
+	OutTradeNo string
+
+	// Money 退款金额(必填)，单位：元
+	Money string
+
+	// OutRefundNo 商户退款单号(可选)，可避免重复请求退款
+	OutRefundNo string
+}
+
+// RefundQuery 退款查询请求
+type RefundQuery struct {
+	// RefundNo 平台退款单号(与商户退款单号二选一)
+	RefundNo string
+
+	// OutRefundNo 商户退款单号(与平台退款单号二选一)
+	OutRefundNo string
+}
+
+// OrderList 订单列表查询请求
+type OrderList struct {
+	// Offset 查询偏移，从0开始
+	Offset int
+
+	// Limit 每页条数，最大50
+	Limit int
+
+	// Status 过滤订单状态(可选)
+	// -1: 不过滤, 0: 未支付, 1: 已支付
+	Status int
+}
+
+// Transfer 转账请求
+type Transfer struct {
+	// Type 转账方式(必填)
+	// 可选值: alipay(支付宝) / wxpay(微信) / qqpay(QQ钱包) / bank(银行卡)
+	Type string
+
+	// Account 收款方账号(必填)
+	// 支付宝账号 / 微信OpenId / 银行卡号
+	Account string
+
+	// Name 收款方姓名(可选)，传入则校验账号与姓名是否匹配
+	Name string
+
+	// Money 转账金额(必填)，单位：元
+	Money string
+
+	// Remark 转账备注(可选)
+	Remark string
+
+	// OutBizNo 转账交易号(可选)，可避免重复请求转账
+	OutBizNo string
+
+	// BookID 安全发账本ID(可选)，仅支付宝安全发转账可传
+	BookID string
+}
+
+// TransferQuery 转账查询请求
+type TransferQuery struct {
+	// BizNo 系统交易号(与商户交易号二选一)
+	BizNo string
+
+	// OutBizNo 商户交易号(与系统交易号二选一)
+	OutBizNo string
+}