Card issuing overview
Create a card
4min
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 card issuing overview docid\ pze4nyany9uiyfuoldqbf 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 the api basics docid\ hjr4y6ml96zuyj6trytom the tutorial uses these api endpoints api description card issuing docid\ ap2akoyeot12me1ydsij0 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 bank rails & accounts docid\ l9hxcroz7mfrdsih 8lrt cardholder's account number customer id (you get this when you create a customer) configuration id (cr gives you this id when you card issuing overview docid\ pze4nyany9uiyfuoldqbf register the relevant webhook events to receive the webhook events for this tutorial both partner accounts need to banking and payments docid\ dgnysfx9f7pnesmuxnwsp 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/all attributes are required a full list of attributes is found card issuing docid\ ap2akoyeot12me1ydsij0 sample create a card curl x post header 'content type application/json' header 'accept application/json' header 'authorization bearer eyjhbgcioijsuzi1niisinr5cci6ikpxvcisimtpzci6ik0wrtjsa0k0ukrzm1fqwtjnrghgtkrrd01vwxlprfl6t1vsre9fvkrnmeuzt1rnnfewrtjrdyj9 eyjpc3mioijodhrwczovl2nyymnvcy1zyw5kym94lmf1dggwlmnvbs8ilcjzdwiioijhdxromhw2mzg0zmy1odi1otllowq5ywfhzgm3ymuilcjhdwqiolsiahr0chm6ly9hcgkuy3jiy29zlmnvbs8ilcjodhrwczovl2nyymnvcy1zyw5kym94lmf1dggwlmnvbs91c2vyaw5mbyjdlcjpyxqioje2nzyyoda4otqsimv4cci6mty3njm2nzi5ncwiyxpwijoiexntzeljyja0z3djev9gqzbeu1vjnmxvq251qtfymmmilcjzy29wzsi6im9wzw5pzcbwcm9mawxligvtywlsin0 q1a7 henbefyod lzb6crohwhuztjxhdcp3vqkz3ioh4big cq54gezkfzjkrdsw3g28fs0sfu3s3lnpjmlfg6fk5j7rgd642c8k67zsdyow42pxhq1a1ka qumdvur9f05tzs a2wzmp4bpqr9fyq3 y4vxjrkwmpvrplucew8u4ytx15zcmdgtyf1l4fupa9t8day4a7z4rfkxw6axkqx1ufireh9idu3lfkazvb49f7jmtwqdaeis7q ipidn1uxphfprvpcrgz4mjyplibpium dshzzpnzgib9ik0ifkyhihkf1gnke4gwkmim4j4metvthvyezucahatrheq' d '{ \ "accountnumber" "2608927303", \ "customerid" "2b15a695 13dc 4b10 b4e5 af5b0138873c", \ "configurationid" "a6b5a94c f8f9 462b 8ce8 afa400f5b640", \ "firstname" "john", \ "lastname" "smith", \ "phone" { \ "phonetype" "home", \ "phonenumber" "9133413131" \ }, \ "emailaddress" "john%40anygoogle com", \ "shippingaddress" { \ "street1" "lane ave", \ "street2" "string", \ "city" "big town", \ "state" "il", \ "postalcode" "72410", \ "countrycode" "us" \ }, \ "billingaddress" { \ "street1" "lane ave", \ "street2" "string", \ "city" "big town", \ "state" "il", \ "postalcode" "72410", \ "countrycode" "us" \ }, \ "nameoncard" "john smith", \ "shippingtype" "normal", \ "clientidentifier" "string" \ }' 'https //sandbox crbcos com/cardmanagement/v1/cards' 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 8709163d 140c 4d95 a111 afa8009e9cd1 , which you will need to activate a card docid 7odv4poiincuqu8xdyrp0 sample order a card response { "id" "8709163d 140c 4d95 a111 afa8009e9cd1", "partnerid" "cd9c12f4 7691 424a b38b af5b0134c611", "productid" "83bed086 8182 4151 a1e3 af5b01362783", "accountnumber" "2608927303", "status" "unactivated", "statusreasoncode" "notset", "firstname" "john", "lastname" "smith", "shippingaddress" { "street1" "lane ave", "street2" "string", "city" "big town", "state" "il", "postalcode" "72410", "countrycode" "us" }, "billingaddress" { "street1" "lane ave", "street2" "string", "city" "big town", "state" "il", "postalcode" "72410", "countrycode" "us" }, "phone" { "phonetype" "home", "phonenumber" "9133413131" }, "emailaddress" "john\@anygoogle com", "nameoncard" "john smith", "ispinset" false, "adminblocked" false, "fraudsuspect" false, "configurationid" "a6b5a94c f8f9 462b 8ce8 afa400f5b640", "category" "credit", "paymentinstrument" "virtualpan", "processor" "i2c", "shippingtype" "normal", "orderstatus" "orderpending", "replacementstatus" "notapplicable", "customerid" "2b15a695 13dc 4b10 b4e5 af5b0138873c", "clientidentifier" "string", "createdat" "2023 02 13t04 37 29 4869172 05 00", "lastmodifiedat" "2023 02 13t04 37 29 4869172 05 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/8709163d 140c 4d95 a111 afa8009e9cd1" ], "details" \[ { "cardid" "8709163d 140c 4d95 a111 afa8009e9cd1", "status" "unactivated", "statusreasoncode" "notset" } ] } sample cards card created event