transaction.created - Rain

initial release

transaction.created webhook (payment)

Added the transaction.created webhook for payment transactions. This webhook is triggered when a new on-chain payment is initiated to pay down a balance (e.g., a crypto-to-fiat repayment).

Payload Fields

Field	Type	Description
`id`	`string`	Webhook ID
`resource`	`string`	Always `"transaction"`
`action`	`string`	Always `"created"`
`version`	`string`	The webhook version
`body.id`	`string`	The transaction ID
`body.type`	`string`	Always `"payment"` for this webhook
`body.payment.amount`	`number`	Payment amount
`body.payment.currency`	`string`	Currency code (e.g., `usd`)
`body.payment.chainId`	`number`	Blockchain chain ID (e.g., `1` for Ethereum mainnet)
`body.payment.walletAddress`	`string`	Wallet address the payment was sent from (EIP-55 checksummed format)
`body.payment.transactionHash`	`string`	On-chain transaction hash
`body.payment.companyId`	`string` (optional)	Company ID (for corporate accounts)
`body.payment.userId`	`string` (optional)	User ID (for consumer accounts)
`body.payment.status`	`string`	Always `"pending"` for this webhook

Example Payload

{
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "resource": "transaction",
    "action": "created",
    "version": "1.0.0",
    "body": {
        "id": "txn_abc123",
        "type": "payment",
        "payment": {
            "amount": 50000,
            "currency": "usd",
            "chainId": 1,
            "walletAddress": "0x71C7656EC7ab88b098defB751B7401B5f6d8976F",
            "transactionHash": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
            "companyId": "company_456",
            "status": "pending"
        }
    }
}