Crear un pedido desde un carrito
API operation: Open the endpoint in Scalar
Usa POST /carts/{cart_id}/place para crear un pedido desde un carrito. La operación pública actual es Cart.place.
Usa las opciones actuales de pedido del usuario, incluidos tipo de pedido, dirección y momento solicitado; los requisitos de zona de entrega varían según el tipo de pedido. La seguridad del proyecto también puede requerir un código de verificación.
Consulta Actualizar opciones del pedido, Campos de checkout y Descripción general de pagos.
Referencia de OpenAPI
Operación: POST /carts/{cart_id}/place
Parámetros de ruta
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
cart_id | string | Sí | — |
Parámetros de encabezado
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
User-Agent | string | No | — |
X-Forwarded-For | string | No | — |
X-APP-X | string | No | — |
X-SOCKET-ID-X | string | No | — |
Campos del cuerpo de la solicitud
| Nombre | Tipo | Obligatorio |
|---|---|---|
amount | any | No |
delivery_zone_id | any | No |
meta_location | any | No |
on_behalf_of | any | No |
paymethod_data | any | No |
paymethod_id | integer | Sí |
recaptcha_type | string | No |
user_id | any | No |
verification_code | any | No |
Respuestas
| Código | Descripción |
|---|---|
| 200 | Respuesta exitosa. El contenido de result varía según la operación y se devuelve como JSON. |
| 400 | Respuesta de error (error=true). Los errores de validación y de negocio comparten este código. |
| 401 | Envelope de error: sesión ausente, inválida, o nivel de usuario fuera de los permitidos. Respuesta de error para el código declarado por la operación. Consulta result para ver los detalles disponibles. Envelope de error: el proyecto no existe o no tiene una suscripción activa. |
| 404 | Respuesta vacía: la versión de API solicitada no está admitida. |
| 429 | Envelope de error: se excedió un límite de consumo del proyecto (o el sujeto está baneado). Lleva Retry-After y X-RateLimit-Limit/Remaining/Reset/Scope/Key. |
| 500 | Respuesta de error: falló la búsqueda o inicialización del proyecto. |
| 503 | Envelope de error: la aplicación está temporalmente en mantenimiento. Envelope de error: el proyecto está temporalmente en mantenimiento, o los límites de consumo no se pudieron evaluar y el límite aplicable está configurado con on_error = closed (cabecera Retry-After: 1). |