Índice de la documentación

Pedidos

Confirmar un pedido

Aceptas el pedido: se cobra al comprador y pasa a in_progress. Solo para pedidos pending y antes de confirm_before. No lleva cuerpo. Devuelve el pedido actualizado.

POST/orders/{id}/confirm

Permiso necesario: orders:write

En la ruta

idobligatoriotextoIdentificador del pedido.

Petición

curl -X POST "https://europe-west1-primters-web.cloudfunctions.net/api/v1/orders/Xk2pQ9aLm3/confirm" \
  -H "Authorization: Bearer $PRIMTERS_API_KEY"

Respuesta

200
{
  "id": "Xk2pQ9aLm3",
  "object": "order",
  "status": "in_progress",
  "created_at": "2026-12-03T19:12:40.000Z",
  "updated_at": "2026-12-03T20:01:00.000Z",
  "confirm_before": null,
  "confirmed_at": "2026-12-03T20:01:00.000Z",
  "shipped_at": null,
  "delivered_at": null,
  "completed_at": null,
  "cancelled_at": null,
  "customer": {
    "name": "Laura Gómez",
    "phone": "+34600000000"
  },
  "delivery": {
    "method": "shipping",
    "address": {
      "name": "Laura Gómez",
      "street": "Calle Mayor 1, 2.º B",
      "additional_info": null,
      "postal_code": "28013",
      "city": "Madrid",
      "province": "Madrid",
      "country": "ES"
    },
    "pickup_location": null,
    "estimated_date": null
  },
  "note": "Si puede ser, envolver para regalo",
  "items": [
    {
      "product_id": "p8LmR2wq",
      "title": "Taza de cerámica personalizada",
      "reference": "TAZA-350",
      "quantity": 2,
      "quantity_mode": "units",
      "lot_size": null,
      "unit_price": 9.9,
      "total": 19.8,
      "customization": [
        "Color: blanco",
        "Texto: Feliz cumpleaños"
      ],
      "addons": [],
      "image_url": "https://firebasestorage.googleapis.com/…/taza.jpg",
      "design_preview_url": "https://firebasestorage.googleapis.com/…/diseno.png"
    }
  ],
  "amounts": {
    "currency": "EUR",
    "subtotal": 19.8,
    "discount": 0,
    "primts": 0,
    "shipping": 4.5,
    "tax_rate": 0.21,
    "tax": 5.1,
    "total": 29.4,
    "gift_card": 0,
    "commission": 2.94,
    "payout": 26.46,
    "refunded": 0
  },
  "coupon": null,
  "tracking": null,
  "cancellation": null,
  "dispute": null,
  "panel_url": "https://primters.com/es/dashboard/maker/orders"
}

Errores

404not_foundLa ruta no existe, o el pedido o el producto no es de tu tienda.
409invalid_statusEl pedido no está en el estado necesario para esa acción.
409confirm_deadline_passedHa pasado el plazo para confirmar el pedido.

¿Dudas o necesitas algo que no está? Escríbenos a contacto@primters.com indicando, si es un error, la petición que haces y la respuesta que recibes (sin la clave).

Primters 2026 ® Todos los derechos reservados

Métodos de pago
Confirmar un pedido · API de Primters