Once a buyer has uploaded their payment proof via Upload Proof, the seller who owns one of the products in the cart can call this endpoint to update theDocumentation Index
Fetch the complete documentation index at: https://mintlify.com/fredy-rizo/tukit/llms.txt
Use this file to discover all available pages before exploring further.
confirmed_payment status. The controller first validates that shoppingCartId is a well-formed MongoDB ObjectId, then verifies the cart exists, and finally checks that the authenticated user’s _id matches the user._id of at least one product in the cart’s products array — confirming they are the seller. When the payment is fully confirmed (key: 1, name: "Pago"), the server also decrements minCant via a ShoppingCart.findOneAndUpdate call targeted at the matching product subdocument’s _id, reducing the available quantity by the cart’s cantBuy value.
Method and path
Authentication
A valid JWT must be passed in thetoken-access request header. The authenticated user must be the seller — their _id must appear as products[n].user._id inside the specified cart. The buyer cannot call this endpoint to self-approve their own payment.
| Header | Required | Description |
|---|---|---|
token-access | ✅ Yes | JWT of the product owner (seller) |
Path parameters
The MongoDB ObjectId of the shopping cart. The server calls
mongoose.Types.ObjectId.isValid() on this value and returns 400 immediately if the format is invalid — before any database query is made.Request body
Payment status object that will be set on the cart document via
$set.When
confirmed_payment.key === 1 and confirmed_payment.name === "Pago", the server performs an additional write: it calls ShoppingCart.findOneAndUpdate({ _id: product._id }, { $inc: { minCant: -cantBuy } }) where product._id is the _id of the matching product subdocument inside the cart. This decrements minCant by the cart’s cantBuy value (always 1) to signal that one copy of the design has been consumed.Responses
200 — Payment status updated
"Compra validada correctamente"trueThe Mongoose
updateOne result object, containing:Error responses
| Status | msj | Cause |
|---|---|---|
403 | "Sin token" | token-access header is missing |
401 | "Token inexistente" | JWT is invalid or expired |
400 | "ID no válido" | shoppingCartId is not a valid MongoDB ObjectId format |
404 | "Carrito no encontrado" | No ShoppingCart document matches shoppingCartId |
403 | "No tienes permisos para esta función" | Authenticated user is not a seller of any product in this cart |
500 | (error object) | Unexpected server error |