Issuance Events

Tracking account issuance

POST /bank_account is asynchronous: a 201 response is not an activation event. Keep the account pending until the final outcome, and use Fetch Bank Account to reconcile its current status and bank details.

During new personal USD issuance, Inquiry Events signal RFIs that need supporting information or a hosted action. An inquiry_request.answered event does not mean the account is active; further review or RFIs may follow. See Requests for Information.

Use account.created for successful activation and account.issuance.failed for a final unsuccessful issuance outcome. A temporary verification/provider delay can leave an account pending and is not itself a failure event. Handle repeated or delayed deliveries safely and fetch current state when needed.

The migration events below describe existing migration behaviour. Creating an account through the new issuance flow does not automatically migrate historical accounts.

1. Account Created

This webhook event is fired when a bank account that was requested has now been successfully issued and activated.

{
  "event_type": "account.created",
  "entity": "bank_account",
  "data": {
    "id": "548d6eb668f111eda78fe041a4724e32",
    "holder_id": "6289dedc686511eda78fe041a4724e32",
    "holder_type": "person",
    "label": "Yomi's Account",
    "account_name": "CHARLES SUEZ",
    "account_number": "9992740191426913",
    "routing_number": "084106768",
    "bank_name": "Oval Bank",
    "bank_code": null,
    "bank_address": {
      "city": "Memphis",
      "country": "US",
      "line1": "6351 Rahul Ligma",
      "line2": "Suite 92392",
      "postal_code": "38119",
      "state": "TN"
    },
    "currency": "USD",
    "balance": 0,
    "credit_pending": 0,
    "debit_pending": 0,
    "type": "personal_checking",
    "status": "active",
    "is_deleted": false,
    "created_at": "2022-11-20T17:35:23Z",
    "updated_at": "2022-11-20T19:32:50Z"
  }
}

2. Account Issuance Failure

This webhook event is fired when a bank account that was requested was rejected or a failure to issue the account occurred.

{
  "event_type": "account.issuance.failed",
  "entity": "bank_account",
  "data": {
    "id": "548d6eb668f111eda78fe041a4724e32",
    "holder_id": "6289dedc686511eda78fe041a4724e32",
    "holder_type": "person",
    "label": "Yomi's Account",
    "account_name": "CHARLES SUEZ",
    "account_number": null,
    "routing_number": null,
    "bank_name": null,
    "bank_code": null,
    "bank_address": null,
    "currency": "USD",
    "balance": 0,
    "credit_pending": 0,
    "debit_pending": 0,
    "type": "personal_checking",
    "status": "failed",
    "is_deleted": false,
    "created_at": "2022-11-20T17:35:23Z",
    "updated_at": "2022-11-20T19:32:50Z"
  }
}

3. Account Migrated

This webhook event is fired when a previously issued bank account has been replaced and closed by a new account, potentially due to banking partner failures or operational complications. If an account is unable to undergo migration and is closed, this event would not fire.

{
  "event_type": "account.migrated",
  "entity": "bank_account",
  "data": {
    "id": "548d6eb668f111eda78fe041a4724e32",
    "holder_id": "6289dedc686511eda78fe041a4724e32",
    "holder_type": "person",
    "label": "Yomi's Account",
    "account_name": "CHARLES SUEZ",
    "account_number": "9992740191426913",
    "routing_number": "084106768",
    "bank_name": "Oval Bank",
    "bank_code": null,
    "bank_address": {
      "city": "Memphis",
      "country": "US",
      "line1": "6351 Rahul Ligma",
      "line2": "Suite 92392",
      "postal_code": "38119",
      "state": "TN"
    },
    "currency": "USD",
    "balance": 0,
    "credit_pending": 0,
    "debit_pending": 0,
    "type": "personal_checking",
    "status": "closed",
    "is_deleted": false,
    "migration_meta": {
      "previous": null,
      "next": "548d6eb668f111eda78fe041a4724e32",
      "balance_brought": 0,
      "balance_carried": 0,
      "balance_refunded": 0
    },
    "created_at": "2022-11-20T17:35:23Z",
    "updated_at": "2022-11-20T19:32:50Z"
  }
}

4. Account Closed

This webhook event is fired when a previously issued bank account has been closed, potentially due to banking partner failures or operational complications. If an account is migrated successfully, this event will not fire.

{
  "event_type": "account.closed",
  "entity": "bank_account",
  "data": {
    "id": "548d6eb668f111eda78fe041a4724e32",
    "holder_id": "6289dedc686511eda78fe041a4724e32",
    "holder_type": "person",
    "label": "Yomi's Account",
    "account_name": "CHARLES SUEZ",
    "account_number": "9992740191426913",
    "routing_number": "084106768",
    "bank_name": "Oval Bank",
    "bank_code": null,
    "bank_address": {
      "city": "Memphis",
      "country": "US",
      "line1": "6351 Rahul Ligma",
      "line2": "Suite 92392",
      "postal_code": "38119",
      "state": "TN"
    },
    "currency": "USD",
    "balance": 0,
    "credit_pending": 0,
    "debit_pending": 0,
    "type": "personal_checking",
    "status": "closed",
    "is_deleted": false,
    "created_at": "2022-11-20T17:35:23Z",
    "updated_at": "2022-11-20T19:32:50Z"
  }
}

5. Card Created

This webhook event is fired when a card that was requested has now been successfully issued and activated.

{
  "event_type": "card.created",
  "entity": "card",
  "data": {
    "id": "011b7b78b07011ed9e800242ac110002",
    "holder_id": "c74b2fb8a59911eda9df0242ac110002",
    "holder_type": "person",
    "balance": 5000,
    "currency": "USD",
    "brand": "visa",
    "label": "Sandbox",
    "cardholder_name": "JOHN DERRICK",
    "number_masked": "4291**********48",
    "number": "5717e6470392f4865596c394e69740f7",
    "exp_month": "02",
    "exp_year": "2026",
    "cvv": "2f019c0bfc6df5ace5c2341fc840fcf0",
    "pin": null,
    "billing_address": {
      "address_type": "mailing",
      "city": "Missouri",
      "country": "US",
      "line1": "2632 Bouillon Way",
      "line2": "",
      "postal_code": "012916",
      "state": "BA"
    },
    "is_deleted": false,
    "status": "active",
    "created_at": "2023-02-19T16:11:01Z",
    "updated_at": "2023-02-19T16:11:02Z"
  }
}

6. Card Issuance Failure

This webhook event is fired when a card that was requested has now been successfully issued and activated.

{
  "event_type": "card.issuance.failed",
  "entity": "card",
  "data": {
    "id": "011b7b78b07011ed9e800242ac110002",
    "holder_id": "c74b2fb8a59911eda9df0242ac110002",
    "holder_type": "person",
    "balance": 5000,
    "currency": "USD",
    "brand": "visa",
    "label": "Sandbox",
    "cardholder_name": "JOHN DERRICK",
    "number_masked": null,
    "number": null,
    "exp_month": null,
    "exp_year": null,
    "cvv": null,
    "pin": null,
    "billing_address": null,
    "is_deleted": false,
    "status": "failed",
    "created_at": "2023-02-19T16:11:01Z",
    "updated_at": "2023-02-19T16:11:02Z"
  }
}


7. Card Frozen

This webhook event is fired when an active card is frozen as a result of excessive transaction declines on the card due to insufficient funds, or when the balance on the card falls below the minimum allowed threshold.

{
  "event_type": "card.frozen",
  "entity": "card",
  "data": {
    "id": "011b7b78b07011ed9e800242ac110002",
    "holder_id": "c74b2fb8a59911eda9df0242ac110002",
    "holder_type": "person",
    "balance": 40,
    "currency": "USD",
    "brand": "visa",
    "label": "Sandbox",
    "cardholder_name": "JOHN DERRICK",
    "number_masked": "4291**********48",
    "number": "5717e6470392f4865596c394e69740f7",
    "exp_month": "02",
    "exp_year": "2026",
    "cvv": "2f019c0bfc6df5ace5c2341fc840fcf0",
    "pin": null,
    "billing_address": {
      "address_type": "mailing",
      "city": "Missouri",
      "country": "US",
      "line1": "2632 Bouillon Way",
      "line2": "",
      "postal_code": "012916",
      "state": "BA"
    },
    "is_deleted": false,
    "status": "inactive",
    "created_at": "2023-02-19T16:11:01Z",
    "updated_at": "2023-02-19T16:11:02Z"
  }
}

8. Card Closed

This webhook event is fired when an active card is closed as a result of an inability to pay monthly load fees (due to a low balance).

{
  "event_type": "card.closed",
  "entity": "card",
  "data": {
    "id": "011b7b78b07011ed9e800242ac110002",
    "holder_id": "c74b2fb8a59911eda9df0242ac110002",
    "holder_type": "person",
    "balance": 5000,
    "currency": "USD",
    "brand": "visa",
    "label": "Sandbox",
    "cardholder_name": "JOHN DERRICK",
    "number_masked": "4291**********48",
    "number": "5717e6470392f4865596c394e69740f7",
    "exp_month": "02",
    "exp_year": "2026",
    "cvv": "2f019c0bfc6df5ace5c2341fc840fcf0",
    "pin": null,
    "billing_address": {
      "address_type": "mailing",
      "city": "Missouri",
      "country": "US",
      "line1": "2632 Bouillon Way",
      "line2": "",
      "postal_code": "012916",
      "state": "BA"
    },
    "is_deleted": true,
    "status": "closed",
    "created_at": "2023-02-19T16:11:01Z",
    "updated_at": "2023-02-19T16:11:02Z",
    "event_transaction": {
      "id": "01270a2fb07011ed9e800242ac110002",
      "object_type": "card",
      "card_id": "011b7b78b07011ed9e800242ac110002",
      "account_id": null,
      "account_type": null,
      "kind": "charge",
      "deposit_id": null,
      "payout_id": null,
      "charge_id": "0124be79b07011ed9e800242ac110002",
      "linked_transaction_id": null,
      "type": "debit",
      "description": "Sainsbury's Shopping",
      "origin": "platform",
      "category": "closure.liquidation",
      "currency": "USD",
      "amount": 124,
      "balance_before": 124,
      "balance_after": 0,
      "status": "successful",
      "created_at": "2023-02-19 16:11:02",
      "updated_at": "2023-02-19 16:11:02"
    }
  }
}

9. Address Migrated

This webhook event is fired when a previously issued deposit address has been replaced and closed by a new address, potentially due to issuance partner failures or operational complications.

{
   "event_type":"address.migrated",
   "entity":"address",
   "data":{
      "id":"old_address_uuid",
      "is_master":false,
      "label":"Wallet Funding Address",
      "code":"0xc0ffee254729296a45a3885639AC7E10F9d54979",
      "currency":"USDT",
      "network":"TRC20",
      "status":"suspended",
      "migration_meta":{
         "next":"3fc974196be641698a046d57d7b56f9c"
      },
      "created_at":"2026-06-24T10:15:30Z",
      "updated_at":"2026-06-24T10:20:45Z"
   }
}