transaction.created

​

v1.4.0

minor update

currency added to fundMovements entries

Field	Type	Description
spend.fundMovements[].currency	string	The currency of the fund movement amount

​

v1.3.0

minor update

fundMovements field added

Added the fundMovements array to the transaction.created (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.3.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": "created",
    "version": "1.3.0",
    "body": {
        "id": "txn_abc123",
        "type": "spend",
        "spend": {
            "amount": 5000,
            "currency": "USD",
            "localAmount": 4500,
            "localCurrency": "EUR",
            "authorizedAmount": 5000,
            "merchantName": "AMAZON",
            "merchantCity": "Seattle",
            "merchantCountry": "US",
            "merchantCategory": "Online Shopping",
            "merchantCategoryCode": "5411",
            "cardId": "card_123",
            "cardType": "virtual",
            "companyId": "company_456",
            "userId": "user_789",
            "userFirstName": "John",
            "userLastName": "Doe",
            "userEmail": "[e-mail]",
            "status": "pending",
            "authorizedAt": "2026-01-27T15:30:00.000Z",
            "exchangeRate": 1.11,
            "threeDSecure": true,
            "tokenizedSource": "ApplePay",
            "fundMovements": [
                {
                    "hash": "0x9f2c1a7b3e5d4c8f6a0b2d1e3f4c5a6b7d8e9f0a1b2c3d4e5f6a7b8c9d0e1f2a",
                    "chainId": "0x2105",
                    "kind": "auth",
                    "direction": "debit",
                    "amountCents": 5000,
                    "occurredAt": "2026-01-27T15:29:58.000Z"
                }
            ]
        }
    }
}

​

v1.2.0

minor update

tokenizedSource field added

Added the tokenizedSource field to the transaction.created (spend) webhook payload. This field identifies the digital wallet the tokenized card was provisioned to or used through, such as ApplePay, GooglePay, or FidesmoPay, and appears only when the transaction came through a tokenized wallet source. The transaction.requested (spend) webhook already includes this field.

New Field

Field	Type	Description
spend.tokenizedSource	string (optional)	The digital wallet the tokenized card was provisioned to or used through (e.g., ApplePay, GooglePay, FidesmoPay). Present only for transactions made through a tokenized wallet source.

Example Payload

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

​

v1.1.0

minor update

threeDSecure field added

Added the threeDSecure field to the transaction.created (spend) webhook payload. This field indicates whether 3D Secure authentication was used for the transaction.

New Field

Field	Type	Description
spend.threeDSecure	boolean (optional)	Indicates whether 3D Secure authentication was used for the transaction

Example Payload

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

​

v1.0.0

initial release

transaction.created webhook (spend)

Added the transaction.created webhook for spend transactions. Rain triggers this webhook when a card authorization arrives (pending or declined).

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.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 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.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.
spend.iso8583.de41	string (optional)	Terminal ID (ISO 8583 Data Element 41)

Example Payload

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