Update static wallet

Update a static wallet's accepted-asset allow-list, metadata, or webhook URL. Only the fields present in the body are changed.

PATCH/v1/static-wallets/{staticWalletId}API key

Path parameters

FieldTypeDescription
staticWalletIdrequiredstringStatic wallet ID

Request body

FieldTypeDescription
allowedAssetsoptionalAssetID[]New accepted-asset allow-list, as asset id-strings (see GET /v1/assets). When empty or omitted the current list is left unchanged.
allowedAssets values AssetID
USDT_ETHEREUMUSDT_ARBITRUMUSDT_OPTIMISMUSDT_BASEUSDT_BSCUSDT_PLASMAUSDT_POLYGONUSDC_ETHEREUMUSDC_ARBITRUMUSDCE_ARBITRUMUSDC_OPTIMISMUSDC_BASEUSDC_BSCUSDC_PLASMAUSDC_POLYGONETH_ETHEREUMETH_ARBITRUMETH_OPTIMISMETH_BASEXPL_PLASMABNB_BSCPOL_POLYGONTESTCOIN_ETHEREUMTESTCOIN_OPTIMISMTESTCOIN_PLASMATESTSTABLECOIN_ETHEREUMTESTSTABLECOIN_OPTIMISMTESTSTABLECOIN_PLASMA
metadataoptionalobjectReplacement key/value metadata for the static wallet.
webhookUrloptionalstringReplacement webhook URL for this wallet's deposit events.

Response

200 OK

FieldTypeDescription
addressoptionalstringReusable on-chain deposit address of this static wallet. Customers may send accepted assets to it repeatedly; each incoming transfer becomes a deposit.
allowedAssetsoptionalAssetID[]Accepted-asset allow-list, as asset id-strings (see GET /v1/assets). Deposits of assets outside this list are ignored and not credited.
allowedAssets values AssetID
USDT_ETHEREUMUSDT_ARBITRUMUSDT_OPTIMISMUSDT_BASEUSDT_BSCUSDT_PLASMAUSDT_POLYGONUSDC_ETHEREUMUSDC_ARBITRUMUSDCE_ARBITRUMUSDC_OPTIMISMUSDC_BASEUSDC_BSCUSDC_PLASMAUSDC_POLYGONETH_ETHEREUMETH_ARBITRUMETH_OPTIMISMETH_BASEXPL_PLASMABNB_BSCPOL_POLYGONTESTCOIN_ETHEREUMTESTCOIN_OPTIMISMTESTCOIN_PLASMATESTSTABLECOIN_ETHEREUMTESTSTABLECOIN_OPTIMISMTESTSTABLECOIN_PLASMA
createdAtoptionalintegerUnix-milliseconds timestamp when the static wallet was created.
externalIdoptionalstringYour own identifier for this static wallet, echoed from creation. Null when none was provided.
idoptionalstringUnique Suward identifier of the static wallet.
metadataoptionalobjectArbitrary key/value data attached by the merchant, echoed back unchanged.
projectIdoptionalstringIdentifier of the project that owns this static wallet.
updatedAtoptionalintegerUnix-milliseconds timestamp when the static wallet was last updated.
webhookUrloptionalstringWebhook URL that receives this wallet's deposit events. Null when the project default webhook is used.

Errors

400 Bad Request— each returns { errorCode, message, args? }. Codes, retries and limits: Errors & limits

All Static Wallets endpoints

Request

terminal
curl -X PATCH https://api.suward.com/v1/static-wallets/<static_wallet_id> \
-H "X-Api-Key: $SUWARD_API_KEY" \
-H "Content-Type: application/json" \
-d '{"webhookUrl":"https://example.com/webhook"}'

Response · 200 OK

response.json
{
"address": "0xabc…def",
"allowedAssets": [
"USDT_ETHEREUM"
],
"createdAt": 0,
"externalId": "order_abc123",
"id": "obj_abc123",
"metadata": {},
"projectId": "obj_abc123",
"updatedAt": 0,
"webhookUrl": "https://example.com/webhook"
}

Illustrative values. Every field, type and status on this page is generated from the OpenAPI specification.

Something unclear? payments@suward.com — we treat every integration question as a documentation defect.