paascloud/paascloud-master · error · OmcBizException

OMC10031004

OMC10031004

Error message

OMC10031004

What it means

OmcBizException with ErrorCodeEnum.OMC10031004 (code 10031004, message "已付款, 无法取消订单" / order already paid, cannot cancel). Thrown by cancelOrderDoc when the order exists but its status is not NO_PAY (unpaid); only unpaid orders may be cancelled via this API.

Solutions

1. Check order status before calling cancel (order.getStatus() == NO_PAY) and hide the cancel option otherwise.
2. If the order is already paid, use the refund/return flow instead of cancellation.
3. Reload the order status to get the latest state; the frontend may be showing stale data.
4. Retry-safe handling: treat OMC10031004 as an expected business outcome and surface 'order already paid' to the user.

Example fix

// before
orderService.cancelOrderDoc(loginAuthDto, orderNo); // throws if paid
// after
OmcOrder order = orderService.queryByUserIdAndOrderNo(userId, orderNo);
if (order.getStatus() == OmcApiConstant.OrderStatusEnum.NO_PAY.getCode()) {
    orderService.cancelOrderDoc(loginAuthDto, orderNo);
} else {
    log.info("Order {} not cancellable, status={}", orderNo, order.getStatus());
}

OmcOrder order = orderService.queryByUserIdAndOrderNo(userId, orderNo);
if (order == null || order.getStatus() != OmcApiConstant.OrderStatusEnum.NO_PAY.getCode()) {
    throw new IllegalStateException("order " + orderNo + " is not in cancellable (NO_PAY) state");
}

try {
    orderService.cancelOrderDoc(loginAuthDto, orderNo);
} catch (OmcBizException e) {
    if (e.getCode() == 10031004) {
        // already paid: route user to refund flow instead of cancel
    } else { throw e; }
}

When it happens

Trigger: Calling cancelOrderDoc on an order whose status is PAID, SHIPPED, CANCELED, or any state other than OmcApiConstant.OrderStatusEnum.NO_PAY; a payment callback flipped the order to PAID between the user viewing it and clicking cancel.

Common situations: User pays in one tab then cancels in another; race between payment success callback and manual cancellation; client UI showing stale unpaid status; attempting to cancel shipped/completed orders instead of using a refund flow.

Understand the failure class

Background: "Invalid state transition" errors: "status must be X, actually Y", "already rejected/charging/uninstalled", "cannot ... while running" — what they mean when a library rejects your call — this error's family across 31 libraries.

Related errors

• OMC10031003
• OMC10031002
• OMC10031001
• OMC10031005
• UAC10015001

AI-assisted analysis of paascloud/paascloud-master@781281a950 (2026-09-10). Data as JSON: /api/errors/cd87b76718629e7e. Report an issue: GitHub.

Appendix: source

Thrown at paascloud-provider/paascloud-provider-omc/src/main/java/com/paascloud/provider/service/impl/OmcOrderServiceImpl.java:134

		this.reduceProductStock(omcOrderDetailList);
		//清空一下购物车
		this.cleanCart(cartList);

		//返回给前端数据

		return assembleOrderVo(order, omcOrderDetailList);
	}

	@Override
	public int cancelOrderDoc(LoginAuthDto loginAuthDto, String orderNo) {
		Long userId = loginAuthDto.getUserId();
		OmcOrder order = omcOrderMapper.selectByUserIdAndOrderNo(userId, orderNo);
		if (order == null) {
			logger.error("该用户此订单不存在, userId={}, orderNo={}", userId, orderNo);
			throw new OmcBizException(ErrorCodeEnum.OMC10031003);
		}
		if (order.getStatus() != OmcApiConstant.OrderStatusEnum.NO_PAY.getCode()) {
			throw new OmcBizException(ErrorCodeEnum.OMC10031004);
		}
		OmcOrder updateOrder = new OmcOrder();
		updateOrder.setId(order.getId());
		updateOrder.setStatus(OmcApiConstant.OrderStatusEnum.CANCELED.getCode());

		return omcOrderMapper.updateByPrimaryKeySelective(updateOrder);
	}

	@Override
	public PageInfo queryUserOrderListWithPage(Long userId, BaseQuery baseQuery) {
		PageHelper.startPage(baseQuery.getPageNum(), baseQuery.getPageSize());
		List<OmcOrder> orderList = omcOrderMapper.selectByUserId(userId);
		List<OrderVo> orderVoList = assembleOrderVoList(orderList, userId);
		return new PageInfo<>(orderVoList);
	}

	@Override
	public boolean queryOrderPayStatus(Long userId, String orderNo) {

View on GitHub (pinned to 781281a950)