Update a wallet transaction

Add or change a transaction's note, such as what a send was for.

A note is for your team, such as the order a payment was for or why a send went out. It's the only thing that changes: the rest records what happened on the network.

Path

id string Required

The transaction's ID, such as wtx_nXRP8NNOMtb4LySU.

Body

note string

Up to 280 characters. An empty string or null clears it.

Errors

400 invalid_request

A field is missing, unknown or out of range. field names it.
404 not_found

No wallet transaction with that ID belongs to your business.

Any request can also fail on its key or its body. See errors.

Request

curl -X PATCH "https://dash.402pay.co/api/v1/wallet/transactions/wtx_nXRP8NNOMtb4LySU" \  -H "Authorization: Bearer $PAY402_SECRET_KEY" \  -H "Content-Type: application/json" \  -d '{    "note": "Order 1042, Pro plan."  }'

Response200 OK

{  "data": {    "id": "wtx_nXRP8NNOMtb4LySU",    "kind": "wallet_transaction",    "direction": "in",    "status": "confirmed",    "asset": "USDC",    "network": "polygon",    "amount": "49.00",    "value_usd": 4900,    "network_fee_usd": null,    "address": "0x9a3c416D4A81669C01f4515bBDEB93C45d3813fe",    "from_address": "0x136e44a2738dea5217e8d6745463d2a9a84d1421",    "to_address": "0x9a3c416D4A81669C01f4515bBDEB93C45d3813fe",    "tx_hash": "0xc16a611d90302ba917593ed9743f5e734a556e8d2f35bb0d60a2ca02ac99bb20",    "explorer_url": "https://polygonscan.com/tx/0xc16a611d90302ba917593ed9743f5e734a556e8d2f35bb0d60a2ca02ac99bb20",    "payment_id": "pmt_QI02vLdJGd48hBbg",    "note": "Order 1042, Pro plan.",    "created_at": "2026-09-26T21:23:13.447Z"  }}