Webhook events: Cards

common events when you work with cross river accounts, cards and payments, you register for specific webhooks docid\ bn5xtgkjogbe ctwomcbs which have a specific format docid\ oiuk28uourzibrmt8i7rs this table presents cards webhook events that are described in detail below event name description related endpoint cards card ordered docid\ padkatuyio5w0ysaexxwl card has been ordered cards card created docid\ padkatuyio5w0ysaexxwl card created create new card docid\ ejccinvxb0omkja567gum cards card activated docid\ padkatuyio5w0ysaexxwl card has been activated activate card by id docid\ e u42earziwdzoiixuuni cards card status changed docid\ padkatuyio5w0ysaexxwl card state has changed cards card pin set docid\ padkatuyio5w0ysaexxwl set pin for card set pin docid\ yfzldndp2nxsd7hq2tiku cards card suspended docid\ padkatuyio5w0ysaexxwl card use temporarily suspended suspend card docid\ k4juvw 0ny1doxtsovnfx cards card suspended docid\ padkatuyio5w0ysaexxwl card suspended by admin admin block docid\ erw0iiapwtmvyz stwvlj cards card unsuspended docid\ padkatuyio5w0ysaexxwl suspension removed from card unsuspend card docid\ m4isy77gmgybkgwrxliax cards card profile changed docid\ padkatuyio5w0ysaexxwl card profile has been updated change card profile docid\ p tif6ejybagbp4vsieg6 cards card replaced docid\ padkatuyio5w0ysaexxwl card replaced replace card by id docid\ axi2plsucmhxdn8 vhcoh cards card closed docid\ padkatuyio5w0ysaexxwl card closed close card docid 9tdjvhu9s37a 7cqj3vej cards transaction authorized docid\ padkatuyio5w0ysaexxwl card transaction approved cards transaction cleared docid\ padkatuyio5w0ysaexxwl card transaction successfully completed cards transaction declined docid\ padkatuyio5w0ysaexxwl card transaction not approved cards transaction reversed docid\ padkatuyio5w0ysaexxwl payment credited to the originating account cards token provisioningreceived docid\ padkatuyio5w0ysaexxwl wallet provisioning request initiated when user adds card to apple pay/google pay retrieve wallet tokens docid\ xkow0xyhcilyqvzgbturs retrieve specific wallet token docid\ m4qvkvrg6emlcjbmotz 7 update token status docid\ oshmkzditqjd88th2hsxe cards token activationreceived docid\ padkatuyio5w0ysaexxwl token activation requested after provisioning approval retrieve wallet tokens docid\ xkow0xyhcilyqvzgbturs retrieve specific wallet token docid\ m4qvkvrg6emlcjbmotz 7 update token status docid\ oshmkzditqjd88th2hsxe cards token completionreceived docid\ padkatuyio5w0ysaexxwl tokenization process completed token successfully activated retrieve wallet tokens docid\ xkow0xyhcilyqvzgbturs retrieve specific wallet token docid\ m4qvkvrg6emlcjbmotz 7 update token status docid\ oshmkzditqjd88th2hsxe cards 3ds otptransactionreceived docid\ padkatuyio5w0ysaexxwl sent when otp based authentication is initiated 3ds authentication details docid\ su5nvsufruwn28v1o7gm8 simulate authentication docid\ vdmgalvyg 2gld buajxf cards 3ds outofbandtransactionreceived docid\ padkatuyio5w0ysaexxwl sent when out of band authentication is initiated (requires validation) 3ds authentication details docid\ su5nvsufruwn28v1o7gm8 simulate authentication docid\ vdmgalvyg 2gld buajxf validate outofbandother docid 0 mnw4crkx4t gprujlew 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" } ] } card token provisioningreceived sample event { "id" "5e87a305 3813 4776 a7c3 b44f00db703e", "eventname" "cards token provisioningreceived", "status" "pending", "partnerid" "19222b81 0e1e 452d a842 b2f1011c16f3", "createdat" "2026 05 19t09 18 57 057 04 00", "resources" \[ "cardmanagement/v1/cards/89a3ca77 10dc 4b88 b0a7 b4480095d104/tokens/c25cabee 2533 4a46 a52b c74991559bd7" ], "details" \[ { "id" "c25cabee 2533 4a46 a52b c74991559bd7", "cardid" "89a3ca77 10dc 4b88 b0a7 b4480095d104", "correlationid" "", "partnerid" "19222b81 0e1e 452d a842 b2f1011c16f3", "eventdate" "2026 05 19t09 18 20 0000000 04 00", "activetokens" "0", "tokenstate" "inactive", "tokentype" "", "walletidentifier" null } ] } card token activationreceived sample event { "id" "c598ff46 13ef 4c10 830b b44f00dff8f7", "eventname" "cards token activationreceived", "status" "pending", "partnerid" "19222b81 0e1e 452d a842 b2f1011c16f3", "createdat" "2026 05 19t09 35 27 543 04 00", "resources" \[ "cardmanagement/v1/cards/89a3ca77 10dc 4b88 b0a7 b4480095d104/tokens/89a3ca77 10dc 4b88 b0a7 b4480095d104" ], "details" \[ { "id" "89a3ca77 10dc 4b88 b0a7 b4480095d104", "cardid" "89a3ca77 10dc 4b88 b0a7 b4480095d104", "partnerid" "19222b81 0e1e 452d a842 b2f1011c16f3", "eventdate" "2026 05 19t09 35 07 0000000 04 00", "activationcode" "364766", "activationcodeexpiration" "5/22/2026 1 35 07?pm", "activationmethodpreferencetype" "masked email", "activationmethodpreferencevalue" "d @gmail com", "tokenstate" "inactive", "walletidentifier" null } ] } card token completionreceived sample event { "id" "cd1b4b30 c106 4bc1 8ee4 b44f00db703e", "eventname" "cards token completionreceived", "status" "pending", "partnerid" "19222b81 0e1e 452d a842 b2f1011c16f3", "createdat" "2026 05 19t09 18 57 057 04 00", "resources" \[ "cardmanagement/v1/cards/89a3ca77 10dc 4b88 b0a7 b4480095d104/tokens/cbd6c950 1417 4c87 ba18 99fdfd72d9a6", "cardmanagement/v1/cards/89a3ca77 10dc 4b88 b0a7 b4480095d104/tokens/cbd6c950 1417 4c87 ba18 99fdfd72d9a6" ], "details" \[ { "id" "cbd6c950 1417 4c87 ba18 99fdfd72d9a6", "cardid" "89a3ca77 10dc 4b88 b0a7 b4480095d104", "correlationid" "", "partnerid" "19222b81 0e1e 452d a842 b2f1011c16f3", "eventdate" "2026 05 19t09 18 25 0000000 04 00", "activetokens" "0", "tokenstate" "active", "tokentype" "secure element", "finaldecision" "token created", "finaldecisionindicator" "85" }, { "id" "cbd6c950 1417 4c87 ba18 99fdfd72d9a6", "cardid" "89a3ca77 10dc 4b88 b0a7 b4480095d104", "correlationid" "", "partnerid" "19222b81 0e1e 452d a842 b2f1011c16f3", "eventdate" "2026 05 19t09 18 25 0000000 04 00", "activetokens" "0", "tokenstate" "active", "tokentype" "hce", "finaldecision" "otp verification result", "finaldecisionindicator" "00" } ] } cards 3ds otptransactionreceived sample event { "id" "54f57237 64a4 463a a4ee b45600a904b6", "eventname" "cards 3ds otptransactionreceived", "status" "pending", "partnerid" "19222b81 0e1e 452d a842 b2f1011c16f3", "createdat" "2026 05 26t06 15 22 637 04 00", "resources" \[ "cardmanagement/v1/3ds/3a63b0f1 12fb 4eff 81b5 b45600a8ee0f" ], "details" \[ { "id" "3a63b0f1 12fb 4eff 81b5 b45600a8ee0f", "authenticationid" "d8709ba6 2ba1 4130 a73e 0a1a62d4caae", "transactionid" "2c76820c b8a9 4b34 a866 5d87a3edfcb6", "stepuprequestid" "dda5d674 20c4 4d9e 9361 9bf9b53f2cef", "stepupcounter" "1", "stepuptype" "otpsms", "verificationtoken" "847296", "otpreferencecode" "ref 847296", "merchantid" "merch 12345678", "merchantname" "acme", "merchanturl" "https //www examplestore com", "merchantcategorycode" "5411", "merchantcountrycode" "gb", "cardid" "89a3ca77 10dc 4b88 b0a7 b4480095d104", "transactionamount" "10" } ] } cards 3ds outofbandtransactionreceived sample event { "id" "895e7062 bfe5 4d85 b311 b45600a99166", "eventname" "cards 3ds outofbandtransactionreceived", "status" "pending", "partnerid" "19222b81 0e1e 452d a842 b2f1011c16f3", "createdat" "2026 05 26t06 17 22 69 04 00", "resources" \[ "cardmanagement/v1/3ds/ca9cff74 796b 4a22 9e30 b45600a9783b" ], "details" \[ { "id" "ca9cff74 796b 4a22 9e30 b45600a9783b", "authenticationid" "c03c5399 d0ff 4622 aac9 cf102df2edb6", "transactionid" "9a8d9109 fd4d 4c29 afdf 02d97367e196", "stepuprequestid" "7664f11a 4a0b 44cb 8551 d277e51a6068", "stepupcounter" "0", "stepuptype" "outofbandother", "verificationtoken" null, "otpreferencecode" null, "merchantid" "merch 12345678", "merchantname" "acme", "merchanturl" "https //www examplestore com", "merchantcategorycode" "5411", "merchantcountrycode" "gb", "cardid" "89a3ca77 10dc 4b88 b0a7 b4480095d104", "transactionamount" "10" } ] }