transaction.updated

​

v1.2.0

minor update

fundMovements field added

Added the fundMovements array to the transaction.updated (spend) webhook payload. Each entry describes one on-chain fund movement that backs the card transaction. For example, the authorization pull that reserved funds on-chain. Movements are ordered oldest first. You receive this field only if your tenant is opted in to webhook version 1.2.0 or later; earlier versions never include it. When no on-chain movements back the transaction, fundMovements is an empty array.

New Field

Field	Type	Description
spend.fundMovements	array	On-chain fund movements backing the transaction, ordered oldest first. Empty when no movements back the transaction.

fundMovements[] Object

Field	Type	Description
hash	string	The on-chain transaction hash for this movement.
chainId	string	The chain identifier where the movement settled (for example, 0x2105).
kind	string	The type of fund movement. See possible values below.
direction	string	The direction of the movement. Currently always debit.
amountCents	number	The amount moved, in cents.
occurredAt	string	ISO 8601 timestamp of when the movement occurred on-chain.

Possible Values for kind

Value	Description
auth	Initial authorization pull.
incremental_auth	Additional pull for an incremental authorization.
force_post	Pull backing a force-posted settlement.
over_capture	Pull covering a settlement that exceeded the authorized amount.
sweep	Pull that sweeps remaining funds for the transaction.

Example Payload

{
    "resource": "transaction",
    "action": "updated",
    "version": "1.2.0",
    "body": {
        "id": "txn_abc123",
        "type": "spend",
        "spend": {
            "amount": 5000,
            "currency": "USD",
            "localAmount": 4500,
            "localCurrency": "EUR",
            "merchantName": "AMAZON",
            "merchantCity": "Seattle",
            "merchantCountry": "US",
            "merchantCategory": "Online Shopping",
            "merchantCategoryCode": "5411",
            "cardId": "card_123",
            "cardType": "virtual",
            "userId": "user_789",
            "userFirstName": "John",
            "userLastName": "Doe",
            "userEmail": "[e-mail]",
            "status": "reversed",
            "authorizedAt": "2026-01-27T15:30:00.000Z",
            "exchangeRate": 1.11,
            "fundMovements": [
                {
                    "hash": "0x9f2c1a7b3e5d4c8f6a0b2d1e3f4c5a6b7d8e9f0a1b2c3d4e5f6a7b8c9d0e1f2a",
                    "chainId": "0x2105",
                    "kind": "auth",
                    "direction": "debit",
                    "amountCents": 5000,
                    "occurredAt": "2026-01-27T15:29:58.000Z"
                }
            ]
        }
    }
}

​

v1.1.0

minor update

exchangeRate field added

Added the exchangeRate field to the transaction.updated (spend) webhook payload. You receive this field only if your tenant is opted in to webhook version 1.1.0; on the default version 1.0.0, it is never included.

New Field

Field	Type	Description
spend.exchangeRate	number (optional)	The exchange rate used to convert the local transaction amount to the settlement amount (USD). Present for international transactions where currency conversion occurred.

Example Payload

{
    "resource": "transaction",
    "action": "updated",
    "version": "1.1.0",
    "body": {
        "id": "txn_abc123",
        "type": "spend",
        "spend": {
            "amount": 5000,
            "currency": "USD",
            "localAmount": 4500,
            "localCurrency": "EUR",
            "merchantName": "AMAZON",
            "merchantCity": "Seattle",
            "merchantCountry": "US",
            "merchantCategory": "Online Shopping",
            "merchantCategoryCode": "5411",
            "cardId": "card_123",
            "cardType": "virtual",
            "userId": "user_789",
            "userFirstName": "John",
            "userLastName": "Doe",
            "userEmail": "[e-mail]",
            "status": "reversed",
            "authorizedAt": "2026-01-27T15:30:00.000Z",
            "exchangeRate": 1.11
        }
    }
}

​

v1.0.0

initial release

transaction.updated webhook (spend)

Added the transaction.updated webhook for spend transactions. This webhook is triggered when a transaction is updated, such as when an authorization is reversed, the amount changes, or the transaction is declined after initial approval.

Payload Fields

Field	Type	Description
id	string	The transaction ID
type	string	Always spend for this webhook
spend.amount	number	Transaction amount in USD
spend.currency	string	Currency code (e.g., USD)
spend.localAmount	number (optional)	Transaction amount in local currency
spend.localCurrency	string (optional)	Local currency code
spend.authorizedAmount	number (optional)	The authorized amount
spend.authorizationUpdateAmount	number (optional)	The amount by which the authorization changed
spend.authorizationMethod	string (optional)	Method of authorization
spend.merchantName	string	Merchant name
spend.merchantCity	string	Merchant city
spend.merchantCountry	string	Merchant country
spend.merchantCategory	string	Merchant category description
spend.merchantCategoryCode	string	Merchant category code (MCC)
spend.merchantId	string (optional)	Merchant ID
spend.cardId	string	The card ID used for the transaction
spend.cardType	string	The card type (virtual or physical)
spend.companyId	string (optional)	Company ID (for corporate cards)
spend.userId	string	The user ID
spend.userFirstName	string	User’s first name
spend.userLastName	string (optional)	User’s last name
spend.userEmail	string	User’s email
spend.status	string	Transaction status (pending, reversed, or declined)
spend.declinedReason	string (optional)	Reason for decline (only when status is declined)
spend.authorizedAt	string	ISO 8601 timestamp of authorization
spend.signature	string (optional)	Signature for verification
spend.timestamp	number (optional)	Unix timestamp
spend.iso8583.de41	string (optional)	Terminal ID (ISO 8583 Data Element 41)

Status Values

Status	Description
pending	Transaction is still pending settlement
reversed	Authorization was reversed (e.g., voided by merchant)
declined	Transaction was declined after initial authorization

Example Payload

{
    "resource": "transaction",
    "action": "updated",
    "version": "1.0.0",
    "body": {
        "id": "txn_abc123",
        "type": "spend",
        "spend": {
            "amount": 5000,
            "currency": "USD",
            "merchantName": "SUSPICIOUS MERCHANT",
            "merchantCity": "Unknown",
            "merchantCountry": "XX",
            "merchantCategory": "Miscellaneous",
            "merchantCategoryCode": "9999",
            "cardId": "card_123",
            "cardType": "virtual",
            "userId": "user_789",
            "userFirstName": "John",
            "userLastName": "Doe",
            "userEmail": "[e-mail]",
            "status": "declined",
            "declinedReason": "suspected fraud",
            "authorizedAt": "2026-01-27T15:30:00.000Z"
        }
    }
}