Skip to main content

Introduction

Bastion sends transaction notification events whenever a cryptocurrency transfer changes status. These events notify your app of status updates related to transfers submitted via the Submit Cryptocurrency Transfer API. Crypto transfers that Bastion makes internally as part of an off-ramp conversion don’t send these events. Track off-ramp progress with conversion notifications instead. Bastion sends a webhook on every status change, not just at the terminal state. The top-level id equals data.id (the transfer ID) and repeats across a transfer’s events. Deduplicate on id + status, and use request_id to correlate events with your original request. Make your handler idempotent.

Destination types

Event payloads include a destination_type field that indicates where the transfer was sent.

Transfer statuses

The status field reflects the current state of the transfer. Statuses fall into two categories: intermediate (more updates will follow) and terminal (no further updates).
Note: Bastion automatically cancels transfers that are not confirmed within 5 minutes of submission to prevent stale execution.

Cryptocurrency transfer events


Field reference