Sign in
Reference

Events

Every state change on Theyutes fires an event. 27 events across 7 groups, signed and delivered with retries.

Subscribe to events on a per-endpoint basis in Developers → Webhooks. Each event below has its own page with a sample payload envelope, when-it-fires note, and suggested use cases.

Orders

order.createdbuyer
A buyer completed checkout and Paystack confirmed payment.
order.status_changed
The merchant or ops moved an order between states (processing → in transit → delivered, etc).
order.cancelled
An order was cancelled — by buyer, merchant, or system.
order.refunded
A refund was issued — partial or full. Payload includes the deduction amount.
shipment.delivered
Carrier confirmed delivery and POD captured.

Logistics

shipment.created
A new shipment was dispatched (order-bound or external).
shipment.assigned
A carrier accepted the shipment and a driver is en route to pickup.
shipment.picked_up
The driver collected the parcel from the pickup point.
shipment.in_transit
The driver is on the way to the dropoff.
shipment.exception
Delivery hit an exception (failed pickup, customer unreachable, returned to sender).
shipment.cancelled
A shipment was cancelled before pickup — by merchant action or via the cancel API.
shipment.stuck
A shipment has been in a non-terminal state longer than its threshold (pending > 10m, assigned > 25m, en_route_pickup > 45m, picked_up > 90m). Subscribe to escalate to ops, call the rider, or refund the buyer.
rider.sos
A rider has triggered the emergency SOS button — accident, threat, medical, or stuck. Payload includes the rider id, last-known lat/lng, reason, and free-text note. Subscribe ops to dispatch help immediately; this is highest-priority and bypasses the standard retry curve.

Payments

payment.capturedbuyer
Paystack confirmed funds. Same time as order.created.
discount.redeemedbuyer
A buyer used a discount code at checkout.
payout.initiated
Theyutes started a Paystack Transfer for a settlement period.
payout.settled
Paystack confirmed the bank credited the merchant.

Catalog

product.updated
A product was created or edited via dashboard, API, or import.
inventory.low_stockbuyer
A variant crossed its low-stock threshold. Useful for restock automations.

Customers

customer.createdbuyer
A new Customer row was created (first purchase from a buyer). Use this to sync to your CRM.

Vault

vault.listedbuyer
A buyer published a wardrobe piece to the Vault for resale. Payload includes the ask price and condition rating.
vault.sold
A Vault listing was bought. Payload includes the gross sale, platform commission, and the seller payout amount.

Atelier

outfit.createdbuyer
A buyer committed an outfit in The Atelier — either composed by Ase or self-curated.
calendar.event_addedbuyer
A buyer added an occasion (wedding, owambe, naming, work event) to their personal Atelier calendar.
friend.connectedbuyer
Two buyers accepted a friend invite in The Atelier. Honour the agreed share level when reacting.
gift.sentbuyer
A buyer started a gift flow for a friend (a Gift row was created). Fires before the sender has paid; orderId is null on the payload.
gift.delivered
A buyer's gift was confirmed delivered to the recipient. Use this to trigger a 'gift waiting in your wardrobe' nudge.