Cards

cards apis cross river card issuing lets you offer customers different types of debit card products these products, known as instrument types , include contact less and virtual cards get started docid\ z mvwov p00 xx082nabk with cross river apis get calls add query parameters to filter the response the api returns to general get calls use pagination docid 6ekvquywevh9x4zxmuklj to control presentation of your results api calls action api call description create new card docid\ ejccinvxb0omkja567gum post /cardmanagement/v1/cards requests creation of a new card activate card by id docid\ e u42earziwdzoiixuuni post /cardmanagement/v1/cards/{id}/activate activates a card for a customer this is the preferred way to activate a card set pin docid\ yfzldndp2nxsd7hq2tiku put /cardmanagement/v1/cards/{id}/pin sets the customer pin replace card by id docid\ axi2plsucmhxdn8 vhcoh post /cardmanagement/v1/cards/{id}/replace order a replacement for damaged, lost or stolen cards card details docid 8dktw3whbplklaqxfwwmu get /cardmanagement/v1/cards returns details about all cards based on the input card details by id docid\ r5zwm6vkwz vs8 uvbzoh get /cardmanagement/v1/cards/{id} returns the details of a specific debit card based on its id transaction details by id docid\ nkkkza00pxt9pved3nfwm get /cardmanagement/v1/transactions/{id} returns information about card transactions based on partner id change card profile docid\ p tif6ejybagbp4vsieg6 put /cardmanagement/v1/cards/{id}/profile retrieves the profile associated to a card suspend card docid\ k4juvw 0ny1doxtsovnfx post /cardmanagement/v1/cards/{id}/suspend suspends a card based on card id unsuspend card docid\ m4isy77gmgybkgwrxliax post /cardmanagement/v1/cards/{id}/unsuspend unsuspends a card based on card id admin block docid\ erw0iiapwtmvyz stwvlj post /cardmanagement/v1/cards/{id}/admin block card blocked by admin status returned is suspended close card docid 9tdjvhu9s37a 7cqj3vej post cardmanagement/v1/cards/{id}/close permanently deactivates a card closed cards cannot be reactivated set card controls docid\ r cxcl0l2uoywkuujpaj1 put /cardmanagement/v1/cards/{cardid}/controls limit the amount of money that can be spent through different channels in a given period get card controls docid\ at16wgxzgov5cqfufnptp get /cardmanagement/v1/cards/{cardid}/controls limit the amount of money that can be spent through different channels in a given period retrieve wallet tokens docid\ xkow0xyhcilyqvzgbturs get /cardmanagement/v1/cards/{cardid}/tokens retrieve all wallet tokens associated with a card retrieve specific wallet token docid\ m4qvkvrg6emlcjbmotz 7 get /cardmanagement/v1/cards/{cardid}/tokens/{tokenid} retrieve a specific wallet token by its cross river token id update token status docid\ oshmkzditqjd88th2hsxe put /cardmanagement/v1/cards/{cardid}/tokens/{tokenid} update token status (suspend, resume, delete) 3ds authentication details docid\ su5nvsufruwn28v1o7gm8 get /cardmanagement/v1/3ds/{id} this api enables you to get your webhook event details validate outofbandother docid 0 mnw4crkx4t gprujlew post /cardmanagement/v1/3ds/{id}/validate enables you to proactively notify when a transaction has completed simulations sandbox only action api call description simulate card auth docid\ klhkl7f7udkckg4lk2vwi post /cardmanagement/v1/simulate/authorization simulates merchant authorization simulate card clearing docid\ jkywjbbj5vzss 4vyapdu post /cardmanagement/v1/simulate/clearing simulates replacement of a memo post with a core transaction simulate card reversal docid zu5qby2byatnkskhgmx post /cardmanagement/v1/simulate/reversal simulates the reversal an existing authorization this reverses the original authorization placed on the account and removes it from the deposit account activity simulate card incremental docid\ rtqomdun8iwgfogeqzpav post /cardmanagement/v1/simulate/incremental simulates an incremental transaction reflected in the deposit account activity simulate single message clearing docid\ foehddyznvdgf e2qnxl7 post /cardmanagement/v1/simulate/single message clearing simulates verification and requires the cardholder to enter their pin to authorize and clear their transaction simulate single message reversal docid\ o5jr5y2scriic2hagqxgl post /cardmanagement/v1/simulate/single message reversal simulates a reversal transaction to a single message clearing transaction simulate wallet provisioning approval docid 23mdxoy5tf6tgyerc16so post /cardmanagement/v1/simulate/tokenization/approve provisioning simulate an approval of a wallet provisioning request simulate activation passcode docid\ hf101eqwnlq5o3x8pxtdl post /cardmanagement/v1/simulate/tokenization/send passcode simulate sending activation passcode to cardholder simulate tokenization completion docid\ vz irikmkcgik oim5 ga post /cardmanagement/v1/simulate/tokenization/token completed simulate completion of tokenization process simulate authentication docid\ vdmgalvyg 2gld buajxf post /cardmanagement/v1/simulate/3ds/authenticate simulates a card transaction 3ds authentication with otp (one time passcode) the otp will be sent to your chosen webhook url or oob (out of band) that interacts with a 3rd party application related topics webhook events cards docid\ padkatuyio5w0ysaexxwl request and response codes cards docid 6ntoaxwfuc2rbx vn4 sw error codes cards docid\ vofiurcg2tmteqoawvl74 tutorials see our api tutorials to learn how to create a card docid\ rzzrd7am62 ktyv9g1n9 create and order a new card activate a card docid\ wzyv6qgm31ldteagrt2fc change the card status to active simulate card management docid\ cy6inx4o9cej74fovu7o6 test the system with our card simulation endpoints