Cards
Webhook events
17 min
when you work with cross river accounts, cards and payments, you register for specific accounts, cards and payment events which have a specific event formats this table presents cards webhook events that are described in detail below event name description webhook events /#order a card card has been ordered webhook events /#create a card card created webhook events /#activate a card card has been activated webhook events /#card status has changed card state has changed webhook events /#set a card pin set pin for card webhook events /#card has been suspended card use temporarily suspended webhook events /#card has been unsuspended suspension removed from card webhook events /#change card profile card profile has been updated webhook events /#card replaced card replaced webhook events /#card suspended by admin card suspended by admin webhook events /#card closed card closed webhook events /#cardstransactionauthorized card transaction approved webhook events /#cardstransactioncleared card transaction successfully completed webhook events /#cardstransactiondeclined card transaction not approved webhook events /#cardstransactionreversed payment credited to the originating account card issuing order a card sample event { "id" "1a175de4 5e0a 47af 8e56 b2f200d6cf7a", "eventname" "cards card ordered", "status" "pending", "partnerid" "1e5d3f04 ae24 4af6 9e30 aecf012b99dd", "createdat" "2025 06 04t09 02 06 05+00 00", "resources" \[ "cardmanagement/v1/cards/e29b514d a71d 494d 86da b2f200d6be43" ], "details" \[ { "cardid" "e29b514d a71d 494d 86da b2f200d6be43", "status" "unactivated", "statusreasoncode" "notset", "fraudsuspect" "false", "adminblocked" "false" } ] } create a card sample event { "id" "b757dedd 1156 4e7e 9178 b2f200d6cf7b", "eventname" "cards card created", "status" "pending", "partnerid" "1e5d3f04 ae24 4af6 9e30 aecf012b99dd", "createdat" "2025 06 04t09 02 06 067+00 00", "resources" \[ "cardmanagement/v1/cards/e29b514d a71d 494d 86da b2f200d6be43" ], "details" \[ { "cardid" "e29b514d a71d 494d 86da b2f200d6be43", "status" "unactivated", "statusreasoncode" "notset", "fraudsuspect" "false", "adminblocked" "false" } ] } activate a card sample event { "id" "ab1e566b de09 4004 ba19 b2f200d78196", "eventname" "cards card activated", "status" "pending", "partnerid" "1e5d3f04 ae24 4af6 9e30 aecf012b99dd", "createdat" "2025 06 04t09 04 38 043+00 00", "resources" \[ "cardmanagement/v1/cards/e29b514d a71d 494d 86da b2f200d6be43" ], "details" \[ { "cardid" "e29b514d a71d 494d 86da b2f200d6be43", "status" "active", "statusreasoncode" "notset", "fraudsuspect" "false", "adminblocked" "false", "previousstatus" "unactivated", "previousstatusreasoncode" "notset", "previousfraudsuspect" "false", "previousadminblocked" "false" } ] } card status has changed sample event { "id" "07d815aa 696d 4643 8ab9 b2f200d78195", "eventname" "cards card status changed", "status" "pending", "partnerid" "1e5d3f04 ae24 4af6 9e30 aecf012b99dd", "createdat" "2025 06 04t09 04 38 043+00 00", "resources" \[ "cardmanagement/v1/cards/e29b514d a71d 494d 86da b2f200d6be43" ], "details" \[ { "cardid" "e29b514d a71d 494d 86da b2f200d6be43", "status" "active", "statusreasoncode" "notset", "fraudsuspect" "false", "adminblocked" "false", "previousstatus" "unactivated", "previousstatusreasoncode" "notset", "previousfraudsuspect" "false", "previousadminblocked" "false" } ] } set a card pin sample event { "id" "60207330 ac6d 408d a71f b2f200d80d2b", "eventname" "cards card pin set", "status" "pending", "partnerid" "1e5d3f04 ae24 4af6 9e30 aecf012b99dd", "createdat" "2025 06 04t09 06 37 157+00 00", "resources" \[ "cardmanagement/v1/cards/e29b514d a71d 494d 86da b2f200d6be43" ], "details" \[ { "cardid" "e29b514d a71d 494d 86da b2f200d6be43", "status" "active", "statusreasoncode" "notset", "fraudsuspect" "false", "adminblocked" "false" } ] } card has been suspended sample event { "id" "11c8368c 6b2f 42a5 9bb4 b2f200d89d3d", "eventname" "cards card suspended", "status" "pending", "partnerid" "1e5d3f04 ae24 4af6 9e30 aecf012b99dd", "createdat" "2025 06 04t09 08 40 093+00 00", "resources" \[ "cardmanagement/v1/cards/e29b514d a71d 494d 86da b2f200d6be43" ], "details" \[ { "cardid" "e29b514d a71d 494d 86da b2f200d6be43", "status" "suspended", "statusreasoncode" "notset", "fraudsuspect" "false", "adminblocked" "false", "previousstatus" "active", "previousstatusreasoncode" "notset", "previousfraudsuspect" "false", "previousadminblocked" "false" } ] } card has been unsuspended sample event { "id" "53979cb2 a5fc 431a b068 b2f200d92ba9", "eventname" "cards card unsuspended", "status" "pending", "partnerid" "1e5d3f04 ae24 4af6 9e30 aecf012b99dd", "createdat" "2025 06 04t09 10 41 623+00 00", "resources" \[ "cardmanagement/v1/cards/e29b514d a71d 494d 86da b2f200d6be43" ], "details" \[ { "cardid" "e29b514d a71d 494d 86da b2f200d6be43", "status" "active", "statusreasoncode" "notset", "fraudsuspect" "false", "adminblocked" "false", "previousstatus" "suspended", "previousstatusreasoncode" "notset", "previousfraudsuspect" "false", "previousadminblocked" "false" } ] } change card profile sample event { "id" "9d6bc42e aa79 4bc7 8d74 b2f200d9ff46", "eventname" "cards card profile changed", "status" "pending", "partnerid" "1e5d3f04 ae24 4af6 9e30 aecf012b99dd", "createdat" "2025 06 04t09 13 42 203+00 00", "resources" \[ "cardmanagement/v1/cards/e29b514d a71d 494d 86da b2f200d6be43" ], "details" \[ { "cardid" "e29b514d a71d 494d 86da b2f200d6be43", "status" "active", "statusreasoncode" "notset", "fraudsuspect" "false", "adminblocked" "false" } ] } card replaced sample event { "id" "5fcae666 d3f3 45c3 b67c b2f200da6c3e", "eventname" "cards card replaced", "status" "pending", "partnerid" "1e5d3f04 ae24 4af6 9e30 aecf012b99dd", "createdat" "2025 06 04t09 15 15 19+00 00", "resources" \[ "cardmanagement/v1/cards/7484bc54 47d4 441c a409 b2f200da5aff" ], "details" \[ { "cardid" "7484bc54 47d4 441c a409 b2f200da5aff", "previouscardid" "e29b514d a71d 494d 86da b2f200d6be43", "status" "unactivated", "statusreasoncode" "notset" } ] } card suspended by admin sample event { "id" "7054e36b 2c8f 401b 8853 b2f200db1c1f", "eventname" "cards card suspended", "status" "pending", "partnerid" "1e5d3f04 ae24 4af6 9e30 aecf012b99dd", "createdat" "2025 06 04t09 17 45 277+00 00", "resources" \[ "cardmanagement/v1/cards/7484bc54 47d4 441c a409 b2f200da5aff" ], "details" \[ { "cardid" "7484bc54 47d4 441c a409 b2f200da5aff", "status" "suspended", "statusreasoncode" "notset", "fraudsuspect" "false", "adminblocked" "true", "previousstatus" "active", "previousstatusreasoncode" "notset", "previousfraudsuspect" "false", "previousadminblocked" "false" } ] card closed sample event { "id" "ba915833 4fe3 4e41 84c3 b2f200db64be", "eventname" "cards card closed", "status" "pending", "partnerid" "1e5d3f04 ae24 4af6 9e30 aecf012b99dd", "createdat" "2025 06 04t09 18 47 247+00 00", "resources" \[ "cardmanagement/v1/cards/7484bc54 47d4 441c a409 b2f200da5aff" ], "details" \[ { "cardid" "7484bc54 47d4 441c a409 b2f200da5aff", "status" "closed", "statusreasoncode" "notset", "fraudsuspect" "false", "adminblocked" "false", "previousstatus" "suspended", "previousstatusreasoncode" "notset", "previousfraudsuspect" "false", "previousadminblocked" "true" } ] } card transactions cards transaction authorized sample event { "id" "af816e87 15c4 4bd3 a7cd b2f3012e950f", "eventname" "cards transaction authorized", "status" "pending", "partnerid" "1e5d3f04 ae24 4af6 9e30 aecf012b99dd", "createdat" "2025 06 05t14 21 40 103+00 00", "resources" \[ "cardmanagement/v1/transactions/49e8a49f 6750 49dd aaff b2f3012e72d9" ], "details" \[ { "transactionid" "49e8a49f 6750 49dd aaff b2f3012e72d9", "outboundresponsecode" "00", "accountnumber" "2434801953", "memopostid" "fcea0e4d ff12 415d 9b1b b2f3012e72ef", "coretransactionid" null, "description" "015963889974 streamflix anywhere nyusa billpayment on 2434801953", "processingcode" "billpayment", "amount" "1999", "processor" "i2c", "messagetype" "0100" } ] } cards transaction cleared sample event { "id" "c3dd1a56 f1e4 48ed 8dcf b2f3012f21c5", "eventname" "cards transaction cleared", "status" "pending", "partnerid" "1e5d3f04 ae24 4af6 9e30 aecf012b99dd", "createdat" "2025 06 05t14 23 40 163+00 00", "resources" \[ "cardmanagement/v1/transactions/ae6cf986 2cbf 4754 bc5e b2f3012f050b" ], "details" \[ { "transactionid" "ae6cf986 2cbf 4754 bc5e b2f3012f050b", "outboundresponsecode" "00", "accountnumber" "2434801953", "memopostid" "fcea0e4d ff12 415d 9b1b b2f3012e72ef", "coretransactionid" "ae6cf986 2cbf 4754 bc5e b2f3012f050b", "description" "015963889974 streamflix anywhere nyusa billpayment on 2434801953", "processingcode" "billpayment", "amount" "1999", "processor" "i2c", "messagetype" "0200" } ] } cards transaction declined sample event { "id" "fdc69fac 4e37 436c 9f2e b2f3012ffa8e", "eventname" "cards transaction declined", "status" "pending", "partnerid" "1e5d3f04 ae24 4af6 9e30 aecf012b99dd", "createdat" "2025 06 05t14 26 45 153+00 00", "resources" \[ "cardmanagement/v1/transactions/a47edf85 3417 4fb3 a071 b2f3012fd6e7" ], "details" \[ { "transactionid" "a47edf85 3417 4fb3 a071 b2f3012fd6e7", "outboundresponsecode" "51", "accountnumber" "2434801953", "memopostid" null, "coretransactionid" null, "description" "976310542139 streamflix anywhere nyusa billpayment on 2434801953", "processingcode" "billpayment", "amount" "700000", "processor" "i2c", "messagetype" "0100" } ] } cards transaction reversed sample event { "id" "d85606f7 3584 4958 9266 b2f301334d0e", "eventname" "cards transaction reversed", "status" "pending", "partnerid" "1e5d3f04 ae24 4af6 9e30 aecf012b99dd", "createdat" "2025 06 05t14 38 50 913+00 00", "resources" \[ "cardmanagement/v1/transactions/94d112f2 7c94 4178 a832 b2f3013343bc" ], "details" \[ { "transactionid" "94d112f2 7c94 4178 a832 b2f3013343bc", "outboundresponsecode" "00", "accountnumber" "2434801953", "memopostid" "8e29c5d1 627d 4c25 9181 b2f30133342c", "coretransactionid" null, "description" "(reversal) 873023855855 coffee xpress anywhere nyusa purchase on 2434801953", "processingcode" "purchase", "amount" "742", "processor" "i2c", "messagetype" "0420" } ] }