Webhooks let GlacierPay push settlement updates to your systems as they happen, so you do not have to poll for status. This keeps your ledger and operations tooling in step with each leg of a trade in near real time.
Subscribing to events
An administrator registers an endpoint URL and selects the events to receive. When a settlement changes state, we send a signed message to your endpoint describing the trade, the leg, and its new status.
- Settlement moving into progress on either leg
- Crypto legs accumulating network confirmations
- A leg reaching settled and reconciled
- A leg placed on hold or requiring your attention
Verifying and responding
Every webhook carries a signature you should verify against your signing secret before acting on it. This confirms the message genuinely came from GlacierPay and was not altered in transit.
Respond quickly with a success status and process the event asynchronously. Design your handler to tolerate the same event arriving more than once, so a retry never causes a duplicate update in your systems.