f

app/main/api/desc/front/pay.api

@@ -22,6 +22,15 @@ service main {
 	// 微信退款回调
 	@handler WechatPayRefundCallback
 	post /pay/wechat/refund_callback
+
+	// 微信小程序虚拟支付发货推送（GET 验签 + POST 事件）
+	@handler XpayPush
+	get /pay/xpay/push
+	post /pay/xpay/push
+
+	// 运维：xpay 手动补发货
+	@handler XpayAdminDeliver
+	post /pay/xpay/admin/deliver (XpayAdminDeliverReq) returns (XpayAdminDeliverResp)
 }
 
 @server (
@@ -70,3 +79,15 @@ type (
 	}
 )
 
+type (
+	XpayAdminDeliverReq {
+		OrderNo string `json:"order_no" validate:"required"`
+	}
+	XpayAdminDeliverResp {
+		Credited     bool     `json:"credited"`
+		Notified     bool     `json:"notified"`
+		WechatDetail string   `json:"wechat_detail"`
+		Errors       []string `json:"errors"`
+	}
+)
+