Webhooks
The Pagamio VAS API does not currently support outbound webhooks.
There is no endpoint to register a webhook URL, and the platform will never make HTTP callbacks to your servers about transaction events.
Use Polling Instead
To know the final state of a transaction, query the POST /transactions endpoint with the transactionId returned by /purchase.
Recommended Polling Strategy
| Time since submission | Poll interval |
|---|---|
| 0 – 60 seconds | every 5 seconds |
| 1 – 5 minutes | every 30 seconds |
| > 5 minutes | every 5 minutes; raise a support ticket if still non-terminal |
Stop Conditions
Stop polling as soon as the transaction reaches a terminal state:
COMPLETED(code0) — success.FAILED(code3) — terminal failure.
For the full lifecycle, see Transaction Lifecycle.
Why No Webhooks (Yet)
Most VAS responses are returned synchronously on POST /purchase. Polling covers the small percentage of transactions that go asynchronous. Webhooks are on the roadmap and this page will be updated when they ship.
Last updated: April 2026