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://wallet.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."
  }'

const response = await fetch("https://wallet.402pay.co/api/v1/wallet/transactions/wtx_nXRP8NNOMtb4LySU", {
  method: "PATCH",
  headers: {
    Authorization: `Bearer ${process.env.PAY402_SECRET_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    note: "Order 1042, Pro plan."
  }),
});
const { data } = await response.json();

import os

import requests

response = requests.patch(
    "https://wallet.402pay.co/api/v1/wallet/transactions/wtx_nXRP8NNOMtb4LySU",
    headers={
        "Authorization": f"Bearer {os.environ['PAY402_SECRET_KEY']}",
    },
    json={
        "note": "Order 1042, Pro plan."
    },
)
data = response.json()["data"]

Response200 OK

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