Create a card

in this tutorial, you'll learn how to ✅ create and order a new card if you are new to card issuing we recommend you read the cards concept pages before starting this tutorial the tutorial assumes you have a knowledge of apis and how they work for more information on sending api calls, see structure the tutorial uses this api endpoint api description create a new card requests creation of a new debit card the tutorial uses these webhooks webhook description cards card created debit card created before you begin make sure you have quickstart cardholder's account number customer id (you get this when you create a customer) configuration id register relevant webhook events to receive the webhook events for this tutorial both partner accounts need to accounts, cards and payment events each specific webhook event type once you are registered, the event objects are sent to the registered urls the event object contains a list of resource identifiers used to download details on each event order a new card in this tutorial you will learn how to order/create a new debit card by creating a card for john smith call post /cardmanagement/v1/cards for this call, some add a card are required sample create a card curl location 'https //sandbox crbcos com/cardmanagement/v1/cards' \\ \ header 'idempotency key b06ab5cc 553a 4fe4 ad78 751b5ff81f0e' \\ \ data raw '{ "accountnumber" "158560897007", "customerid" "e2599a17 d1e2 476c 9672 b2ff008fa575", "configurationid" "b2251a28 c218 4e2e a787 b2f700ef0ecd", "firstname" "daly", "lastname" "khol", "phone" { "phonetype" "home", "phonenumber" "7185551234" }, "emailaddress" "dkhol\@gmail com", "shippingaddress" { "street1" "1 roshar ave", "city" "roshar", "state" "ny", "postalcode" "10001", "countrycode" "us" }, "billingaddress" { "street1" "1 roshar ave", "city" "roshar", "state" "ny", "postalcode" "10001", "countrycode" "us" }, "nameoncard" "daly khol", "shippingtype" "normal", "clientidentifier" "b06ab5cc 553a 4fe4 ad78 751b5ff81f00" } a successful api call returns a json response with the details of the new card the card status will be unactivated until you activate the card the id is the card id, in this example 8c6a53e0 83ad 4b76 b446 b300006a3e6a which you need to activate a card sample order a card response { "id" "8c6a53e0 83ad 4b76 b446 b300006a3e6a", "productid" "57146944 b145 4326 884d b2f700ecf688", "partnerid" "19222b81 0e1e 452d a842 b2f1011c16f3", "accountnumber" "158560897007", "status" "unactivated", "statusreasoncode" "notset", "processorcardstatus" "i", "firstname" "daly", "lastname" "khol", "shippingaddress" { "street1" "1 roshar ave", "city" "roshar", "state" "ny", "postalcode" "10001", "countrycode" "us" }, "billingaddress" { "street1" "1 roshar ave", "city" "roshar", "state" "ny", "postalcode" "10001", "countrycode" "us" }, "phone" { "phonetype" "home", "phonenumber" "7185551234" }, "emailaddress" "dkhol\@gmail com", "nameoncard" "daly khol", "ispinset" false, "adminblocked" false, "fraudsuspect" false, "configurationid" "b2251a28 c218 4e2e a787 b2f700ef0ecd", "category" "debit", "paymentinstrument" "physicalcombo", "processor" "i2c", "shippingtype" "normal", "orderstatus" "orderpending", "replacementstatus" "notapplicable", "customerid" "e2599a17 d1e2 476c 9672 b2ff008fa575", "clientidentifier" "b06ab5cc 553a 4fe4 ad78 751b5ff81f00", "createdat" "2025 06 18t02 26 49 6169047 04 00", "lastmodifiedat" "2025 06 18t02 26 49 6169047 04 00" } when the card is generated at the processor, the cards card created webhook event fires sample cards card created event { "id" "cea6c5b5 13e7 4c2f ba75 afce01110fe5", "eventname" "cards card created", "status" "pending", "partnerid" "cd9c12f4 7691 424a b38b af5b0134c611", "createdat" "2023 02 13t04 42 29 4869172 05 00", "resources" \[ "cardmanagement/v1/cards/8c6a53e0 83ad 4b76 b446 b300006a3e6a" ], "details" \[ { "cardid" "8c6a53e0 83ad 4b76 b446 b300006a3e6a", "status" "unactivated", "statusreasoncode" "notset" } ] }