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"
}
}

