Webhooks

Signed notifications valueverde POSTs to an endpoint you register, when a share purchase you placed changes state. Your endpoint implements these; they are not routes on this API.

📄️ share_purchase.submitted

Delivered when an order you placed has been submitted and accepted into the queue. Implemented by your endpoint, POSTed by valueverde.

📄️ share_purchase.approved

Delivered when the order passes review. Progress, not an ending — settlement still follows. Implemented by your endpoint, POSTed by valueverde.

📄️ share_purchase.rejected

Delivered when the order is refused. Final — nothing further arrives for it, so this is the event that lets you stop polling and tell your customer. Implemented by your endpoint, POSTed by valueverde.

📄️ share_purchase.cancelled

Delivered when the order is cancelled, including by your own call to the cancel endpoint. Final. Implemented by your endpoint, POSTed by valueverde.

📄️ share_purchase.settled

Delivered when the order settles — the point the investor’s holdings change. Implemented by your endpoint, POSTed by valueverde.