Referencia · Webhooks
Se creó un pedido
Eventos que Tiendy envía al endpoint del comercio.
Un pedido nuevo de la tienda, de cualquier canal (data.order.source). Si nace pagado (una venta de caja cobrada), también llega order.paid.
Encabezados
Tiendy-Signaturetextorequeridot=<unix>,v1=<hex>: HMAC-SHA256 con el secreto del endpoint sobre<t>.<cuerpo crudo>.Tiendy-Event-Idtexto (uuid)requeridoIgual a
iddel cuerpo. Sirve para descartar repeticiones.Tiendy-Event-TypetextorequeridoValores:
order.createdorder.paidorder.status_changedorder.proof_uploaded
Cuerpo
application/json, requerido.
idtexto (uuid)requeridoId del evento. Es el mismo en todos los endpoints de la tienda y en cada reintento.
typetextorequeridoValores:
order.createdorder.paidorder.status_changedorder.proof_uploadedcreatedAttexto (date-time)requeridoCuándo ocurrió el evento. Los eventos pueden llegar desordenados.
storeIdtextorequeridodataobjetorequeridoCampos de data (1)
orderobjetorequeridoEl mismo
OrderViewque devuelve la API, sinmetaPurchase(es solo para el navegador) y con el canal del pedido. Sin datos del comprador nipublicToken;trackingUrlsiempre esnull.Campos de order (18)
identerorequeridoNúmero de pedido, para mostrar. Es correlativo y no sirve para operar.
statustextorequeridoValores:
PENDIENTECONFIRMADOPREPARANDOEN_CAMINOENTREGADOCANCELADOpaymentStatustextorequeridoValores:
PENDIENTEPARCIALPAGADOCANCELADOcreatedAttexto (date-time)requeridocurrencytextorequeridolistSubtotalenterobundleSavingsenterosubtotalenterocouponCodetexto o nulocouponDiscountenteroshippingNametexto o nuloshippingPriceentero o nuloNulo si el pedido no tiene método de envío.
totalenterorequeridoEs el monto que vale. Hay que mostrar este, no el cotizado.
lineslista de objetosrequeridoCampos de lines (8)
productIdtexto o nulorequeridoskuIdtexto o nuloproductNametexto o nulorequeridovariantLabeltexto o nuloquantityenterorequeridobundleNametexto o nulobundleDiscountenterorequeridototalenterorequeridoLo cobrado, neto de la oferta.
paymentobjetorequeridoCampos de payment (4)
methodtexto o nulorequeridoValores:
TARJETAEFECTIVOTRANSFERENCIAcustomPaymentMethodIdtexto o nulocustomPaymentMethodNametexto o nulogatewaytexto o nulostripeen un pedido creado con la opciónstripe: se paga conPOST /orders/{token}/pay.nullen todos los demás.Valores:
stripenull
proofobjetorequeridoCampos de proof (2)
requestedbooleanorequeridoMostrar la invitación a subir el comprobante.
uploadedbooleanorequerido
trackingUrltexto (uri) o nuloPágina de seguimiento en Tiendy, la misma que reciben los emails del comprador. Siempre
nullenGET /orders/by-payment-hash/{hash}: la URL incluye elpublicToken.sourcetexto o nulorequeridoCanal del pedido.
nullen pedidos anteriores a la columna.Valores:
STOREFRONTSTOREFRONT_APIMARKETPLACEADMINPOSnull
Respuestas
| Estado | Código | Qué significa |
|---|---|---|
| 2XX | — | Recibido. Cualquier otra respuesta, una redirección o 10 s sin respuesta es un intento fallido. |