Referencia · Webhooks

El comprador subió el comprobante de pago

EVENTOorder.proof_uploaded

Eventos que Tiendy envía al endpoint del comercio.

Encabezados

Tiendy-Signaturetextorequerido

t=<unix>,v1=<hex>: HMAC-SHA256 con el secreto del endpoint sobre <t>.<cuerpo crudo>.

Tiendy-Event-Idtexto (uuid)requerido

Igual a id del cuerpo. Sirve para descartar repeticiones.

Tiendy-Event-Typetextorequerido

Valores:order.createdorder.paidorder.status_changedorder.proof_uploaded

Cuerpo

application/json, requerido.

idtexto (uuid)requerido

Id del evento. Es el mismo en todos los endpoints de la tienda y en cada reintento.

typetextorequerido

Valores:order.createdorder.paidorder.status_changedorder.proof_uploaded

createdAttexto (date-time)requerido

Cuándo ocurrió el evento. Los eventos pueden llegar desordenados.

storeIdtextorequerido
dataobjetorequerido
Campos de data (1)
orderobjetorequerido

El mismo OrderView que devuelve la API, sin metaPurchase (es solo para el navegador) y con el canal del pedido. Sin datos del comprador ni publicToken; trackingUrl siempre es null.

Campos de order (18)
identerorequerido

Número de pedido, para mostrar. Es correlativo y no sirve para operar.

statustextorequerido

Valores:PENDIENTECONFIRMADOPREPARANDOEN_CAMINOENTREGADOCANCELADO

paymentStatustextorequerido

Valores:PENDIENTEPARCIALPAGADOCANCELADO

createdAttexto (date-time)requerido
currencytextorequerido
listSubtotalentero
bundleSavingsentero
subtotalentero
couponCodetexto o nulo
couponDiscountentero
shippingNametexto o nulo
shippingPriceentero o nulo

Nulo si el pedido no tiene método de envío.

totalenterorequerido

Es el monto que vale. Hay que mostrar este, no el cotizado.

lineslista de objetosrequerido
Campos de lines (8)
productIdtexto o nulorequerido
skuIdtexto o nulo
productNametexto o nulorequerido
variantLabeltexto o nulo
quantityenterorequerido
bundleNametexto o nulo
bundleDiscountenterorequerido
totalenterorequerido

Lo cobrado, neto de la oferta.

paymentobjetorequerido
Campos de payment (4)
methodtexto o nulorequerido

Valores:TARJETAEFECTIVOTRANSFERENCIA

customPaymentMethodIdtexto o nulo
customPaymentMethodNametexto o nulo
gatewaytexto o nulo

stripe en un pedido creado con la opción stripe: se paga con POST /orders/{token}/pay. null en todos los demás.

Valores:stripenull

proofobjetorequerido
Campos de proof (2)
requestedbooleanorequerido

Mostrar la invitación a subir el comprobante.

uploadedbooleanorequerido
trackingUrltexto (uri) o nulo

Página de seguimiento en Tiendy, la misma que reciben los emails del comprador. Siempre null en GET /orders/by-payment-hash/{hash}: la URL incluye el publicToken.

sourcetexto o nulorequerido

Canal del pedido. null en pedidos anteriores a la columna.

Valores:STOREFRONTSTOREFRONT_APIMARKETPLACEADMINPOSnull

Respuestas

EstadoCódigoQué significa
2XX—

Recibido. Cualquier otra respuesta, una redirección o 10 s sin respuesta es un intento fallido.