Payments
Card payments
Webhook events
6 min
when you work with cross river accounts, cards and payments, you register for specific card payments which have a specific event formats this table presents card payments webhook events that are described in detail below event name description webhook events docid\ zn y a4 s31ccxlfx8icy a card was authorized webhook events docid\ zn y a4 s31ccxlfx8icy card status changed from oldstatus to newstatus example active to inactive webhook events docid\ zn y a4 s31ccxlfx8icy a transaction was completed webhook events docid\ zn y a4 s31ccxlfx8icy transaction status changed from oldtransactionstatus to newtransactionstatus example succeded to pending webhook events docid\ zn y a4 s31ccxlfx8icy the cos account of the merchant is credited with the amount mentioned on the payload at the timestamp mentioned on the payload event examples cardauthorized sample event { "eventid" "8e153f2e 5876 46aa 32a4 b2e1008a7f53", "eventname" "cardauthorized", "data" { "requestid" "27be8469 d8e6 4186 aa61 57d828ae14d6 "cardtoken" "516093d8f4c1ad7882f01ac73097e864000000", "cardfingerprint" "zwzlzawrljoqk4xnvzzypgx186xzpp4vxesuikdi8hno+s4jg20a7otmwh6qz2w3ei3v5irlkudrimcbf6pvxq==", "authorized" true, "sourcesenderid" "5173a0f8 0931 441e ac27 ae14412336c3", "responsereceived" true, "responsecode" "ok", "responsedescription" "ok", "error" null, "addressverified" true, "rail" "visadirect", "customerreferencenumber" null, "pushenabled" true, "pullenabled" true }, "clientmessagebase64encoded" null, "requestid" "27be8469 d8e6 4186 aa61 57d828ae14d6" } cardstatuschaged sample event { "eventid" "a41c20cb 2cc9 a257 8368 bae420d88a45", "eventname" "cardstatuschanged", "data" { "statuschangedat" "2025 05 21t17 08 23 9055016z", "creditcardid" "a815ce3dbf414961aa11bc4e4c351193000000", "oldstatus" "active", "newstatus" "inactive" }, "clientmessagebase64encoded" null, "requestid" "1e79e774 d218 4850 8355 fe25588c6dbd" } transactioncompleted sample event { "eventid" "92175b24 f01e 4fab 91d4 baf400da765e", "eventname" "transactioncompleted", "data" { "transactionid" "ab82a520 bd1f ed55 9b9e 5140321e7215", "amount" 10000, "sourcesenderid" "7813a0f8 0937 441e 5557 ae19412306c3", "transactionrequestedat" "2025 05 21t17 15 23 3539347z", "transactionstatus" "succeeded", "errordescription" null, "creditcardid" "42abee0ceb7b3314bc087366929541f2000000", "rail" "visadirect", "transactiontype" "pulltransaction", "requesterid" null }, "clientmessagebase64encoded" null, "requestid" "ab82a520 bd1f ed55 9b9e 5140321e7215" } transactionstatuschanged sample event { "eventid" "5d10113d 74d4 4835 be46 ae2300c03745", "eventname" "transactionstatuschanged", "data" { "transactionid" "3c7bf1aa af58 4f71 8345 43f39d8f3378", "amount" 20, "transactionrequestedat" "2022 01 13t14 34 29 0304876", "oldtransactionstatus" "failed", "newtransactionstatus" "succeeded", "statuschangedat" "2022 01 20t16 39 14 3167755z", "creditcardid" "rooxwsjjiv9aukws3iz8likrvszlywwgmdi20f", "rail" "tabapay" }, "clientmessagebase64encoded" null, "requestid" "3c7bf1aa af58 4f71 8345 43f39d8f3378" } accountcreditreceived sample event { "eventid" "880a1390 b516 4801 bb41 88e400d91c0b", "eventname" "accountcreditreceived", "data" { "submerchantid" "3373a0f8 0937 467e ac27 ae19772306c3", "accountnumber" "2726411651", "creditincents" 72500, "credittimestampinutc" "2025 05 21t17 10 28 2938885z" }, "clientmessagebase64encoded" null, "requestid" null }