Saltar al contenido principal
Un pedido (factura) contiene los productos, el cliente y el precio. El cliente paga en el checkout_url alojado, donde elige cualquier método de pago que acepte su tienda. Los pedidos creados mediante la API siguen las mismas reglas que su tienda: los precios provienen de su catálogo, el inventario se reserva, se aplican los cupones y las reglas de producto, y se ejecutan las comprobaciones antifraude.

Crear un pedido

Respuesta (201)
Redirija al cliente a checkout_url. Los pedidos no pagados caducan después de 3 horas.

Productos físicos

Para los productos que se envían, agregue la dirección. Obtenga primero las opciones con POST /shipping/quote, u omita shipping_rate_id para usar la tarifa más económica.
El envío se suma a total_cents y se muestra como shipping_cents. Sin dirección, el cliente la introduce en la página de checkout antes de pagar. Después del pago, envíe el pedido con POST /orders/{invoiceId}/shipments.

Estados del pedido

Escuche el webhook order.completed en lugar de consultar periódicamente. Consulte Webhooks.

Después de crear el pedido

Use su propio ID de pedido como Idempotency-Key en las llamadas de creación, completado y reembolso. Así, los reintentos nunca crean un segundo pedido ni un segundo reembolso.