order

func CloseOrderHandler ¶

func CloseOrderHandler(svcCtx *svc.ServiceContext) app.HandlerFunc

CloseOrderHandler documents Close order.

@Summary Close order @Tags user @Accept json @Produce json @Security BearerAuth @Param request body dto.CloseOrderRequest true "Request parameters" @Success 200 {object} result.ResponseSuccessBean @Router /v1/public/order/close [post]

func PreCreateOrderHandler ¶

func PreCreateOrderHandler(svcCtx *svc.ServiceContext) app.HandlerFunc

PreCreateOrderHandler documents Pre create order.

@Summary Pre create order @Tags user @Accept json @Produce json @Security BearerAuth @Param request body dto.PurchaseOrderRequest true "Request parameters" @Success 200 {object} result.ResponseSuccessBean{data=dto.PreOrderResponse} @Router /v1/public/order/pre [post]

func PurchaseHandler ¶

func PurchaseHandler(svcCtx *svc.ServiceContext) app.HandlerFunc

PurchaseHandler documents purchase Subscription.

@Summary purchase Subscription @Tags user @Accept json @Produce json @Security BearerAuth @Param request body dto.PurchaseOrderRequest true "Request parameters" @Success 200 {object} result.ResponseSuccessBean{data=dto.PurchaseOrderResponse} @Router /v1/public/order/purchase [post]

func QueryOrderDetailHandler ¶

func QueryOrderDetailHandler(svcCtx *svc.ServiceContext) app.HandlerFunc

QueryOrderDetailHandler documents Get order.

@Summary Get order @Tags user @Accept json @Produce json @Security BearerAuth @Param request query dto.QueryOrderDetailRequest false "Request parameters" @Success 200 {object} result.ResponseSuccessBean{data=dto.OrderDetail} @Router /v1/public/order/detail [get]

func QueryOrderListHandler ¶

func QueryOrderListHandler(svcCtx *svc.ServiceContext) app.HandlerFunc

QueryOrderListHandler documents Get order list.

@Summary Get order list @Tags user @Accept json @Produce json @Security BearerAuth @Param request query dto.QueryOrderListRequest false "Request parameters" @Success 200 {object} result.ResponseSuccessBean{data=dto.QueryOrderListResponse} @Router /v1/public/order/list [get]

func RechargeHandler ¶

func RechargeHandler(svcCtx *svc.ServiceContext) app.HandlerFunc

RechargeHandler documents Recharge.

@Summary Recharge @Tags user @Accept json @Produce json @Security BearerAuth @Param request body dto.RechargeOrderRequest true "Request parameters" @Success 200 {object} result.ResponseSuccessBean{data=dto.RechargeOrderResponse} @Router /v1/public/order/recharge [post]

func RenewalHandler ¶

func RenewalHandler(svcCtx *svc.ServiceContext) app.HandlerFunc

RenewalHandler documents Renewal Subscription.

@Summary Renewal Subscription @Tags user @Accept json @Produce json @Security BearerAuth @Param request body dto.RenewalOrderRequest true "Request parameters" @Success 200 {object} result.ResponseSuccessBean{data=dto.RenewalOrderResponse} @Router /v1/public/order/renewal [post]

func ResetTrafficHandler ¶

func ResetTrafficHandler(svcCtx *svc.ServiceContext) app.HandlerFunc

ResetTrafficHandler documents Reset traffic.

@Summary Reset traffic @Tags user @Accept json @Produce json @Security BearerAuth @Param request body dto.ResetTrafficOrderRequest true "Request parameters" @Success 200 {object} result.ResponseSuccessBean{data=dto.ResetTrafficOrderResponse} @Router /v1/public/order/reset [post]

func V2CheckoutHandler ¶ added in v1.14.19

func V2CheckoutHandler(svcCtx *svc.ServiceContext) app.HandlerFunc

@Summary Re-initiate checkout for a pending V2 order @Tags user @Accept json @Produce json @Param orderNo path string true "Order number" @Param request body dto.V2CheckoutOrderRequest true "Checkout capability and return URL" @Success 200 {object} result.ResponseSuccessBean{data=dto.V2OrderResponse} @Router /v2/public/orders/{orderNo}/checkout [post]

func V2CreateAndCheckoutHandler ¶ added in v1.14.19

func V2CreateAndCheckoutHandler(svcCtx *svc.ServiceContext) app.HandlerFunc

V2CreateAndCheckoutHandler combines order creation and checkout initiation. The idempotency key is intentionally a header so browser retry middleware can preserve it independently from a JSON request body.

@Summary Create an order and initiate checkout @Tags user @Accept json @Produce json @Param Idempotency-Key header string true "16-128 character request idempotency key" @Param request body dto.V2CreateOrderRequest true "Order parameters" @Success 200 {object} result.ResponseSuccessBean{data=dto.V2OrderResponse} @Failure 409 {object} result.ResponseErrorBean @Router /v2/public/orders [post]

func V2EventTicketHandler ¶ added in v1.14.19

func V2EventTicketHandler(svcCtx *svc.ServiceContext) app.HandlerFunc

@Summary Refresh a V2 order event stream ticket @Tags user @Accept json @Produce json @Param orderNo path string true "Order number" @Param request body dto.V2EventTicketRequest true "Guest checkout capability when applicable" @Success 200 {object} result.ResponseSuccessBean{data=dto.V2EventTicketResponse} @Router /v2/public/orders/{orderNo}/event-ticket [post]

func V2GetOrderHandler ¶ added in v1.14.19

func V2GetOrderHandler(svcCtx *svc.ServiceContext) app.HandlerFunc

@Summary Get a V2 order state snapshot @Tags user @Produce json @Param orderNo path string true "Order number" @Param checkout_token query string false "Guest checkout capability" @Success 200 {object} result.ResponseSuccessBean{data=dto.V2OrderResponse} @Router /v2/public/orders/{orderNo} [get]

func V2OrderEventsHandler ¶ added in v1.14.19

func V2OrderEventsHandler(svcCtx *svc.ServiceContext) app.HandlerFunc

V2OrderEventsHandler serves a replayable SSE stream. The event table is the source of truth; Redis is only used to wake the handler quickly after an outbox publication. A periodic database catch-up keeps streams correct if Redis or a subscription is briefly unavailable.

@Summary Stream V2 order events @Tags user @Produce text/event-stream @Param orderNo path string true "Order number" @Param ticket query string true "Short-lived order event ticket" @Param Last-Event-ID header string false "Last received event ID" @Param after query string false "Replay cursor when Last-Event-ID is unavailable" @Success 200 {string} string @Router /v2/public/orders/{orderNo}/events [get]

func V2OrderSessionHandler ¶ added in v1.14.19

func V2OrderSessionHandler(svcCtx *svc.ServiceContext) app.HandlerFunc

@Summary Exchange a guest checkout capability for a V2 user session @Tags user @Accept json @Produce json @Param orderNo path string true "Order number" @Param request body dto.V2OrderSessionRequest true "Guest checkout capability" @Success 200 {object} result.ResponseSuccessBean{data=dto.V2OrderSessionResponse} @Router /v2/public/orders/{orderNo}/session [post]