Card product
The nCore platform uses the concept of card product that acts as a template to define characteristics of the cards associated to the card product.
Card product settings
The card product offers different settings, these settings allow you to customize the card product as per your business needs.
- Currency settings: These settings allow you to define the currencies you want to support, the currency in which to settle, the order to use in sweeping the fund, and various controls at currency level.
- Card settings: These settings help to define attributes like BIN (Bank Identification Number), PAN length, PAN range, card initial status on its creation, and other controls at card level.
- Account settings: These settings allow you to link cards with the card product’s account and to configure number of cards per account.
- PIN settings: nCore platform provides you the ability to customize your card PIN settings for attributes like PIN type, PIN length, and number of allowed retries.
- Authorization settings: It provides you to control you card usage on ATMs, in-store POS terminals, E-Commerce with/without 3DS, fallback transactions, and other transaction use cases.
All these features are defined with the card product, it is mandatory to include a card product when creating a card.
The card product is created in ‘Inactive’ status. When a card is issued the status of a card product becomes ‘Active’ automatically. You can create a card product as per your business need by sending a POST request to /cardproducts endpoint as given below.
{
"description": "Some description of the card product",
"currency_settings": [
{
"supported_currency": "USD",
"settlement_currency": "USD",
"priority": 1
}
],
"card_settings": {
"bin": "412345",
"pan_range": [
{ "start_range": 0,
"end_range": 9999999
}
]
}}nCore offers two card product retrieval options.
Retrieve existing card products
You can retrieve all existing card products by sending a GET request to /cardproducts endpoint shown below.
Retrieve a specific card product
You can retrieve a specific card product by sending a GET request to /cardproducts/{id} endpoint, where id is the card product id.
You can update a card product by sending a PUT request to /cardproducts/{id} endpoint as given below.
Once a card product is in ‘Active’ status, certain attributes are not allowed to be modified.
Below you can find the parameters which cannot be updated for an ACTIVE/SUSPENDED card product:
Card settings | PIN settings | Currency settings | Auth settings | Account settings |
|---|---|---|---|---|
BIN | 'pin_retries' if tenant level setting 'allow_card_product_update_pin_retries' is set to 'false' | for base currency,priority=1 | All | All |
PAN length | | | | |
PAN ranges (however, new ranges can be added) | | | | |
soft_expiry_period | | | | |
create_account_with_card | | | | |
initial_status_of_physical_card: "INACTIVE", if 'create_account_with_card':false | | | | |
initial_status_of_virtual_card: "INACTIVE", if 'create_account_with_card':false | | | | |
Last modified 4mo ago