Category links

API Links

Create Virtual Card

Action: POST

Endpoint: /api/CoreCredit/AccountHolders/CreateVirtualCard

Use this API to create virtual cards and assign the attribute such as card limit, expiry option & expiry date.

Request fields details
Fields Description

Source

string

Mandatory

Source of API Consumer For external system expected sources will be WEB.

Allowable Values:

50

IPAddress

string

Optional

IP Address of Client / Application Hosting Server Example: 10.206.0.204

Allowable Values:

15

DateFormat

string

Optional

Place Holder for Future Use. Values are: 1 : MM/dd/yyyy HH:MM:SS (Default) 2 : MM/dd/yy HH:MM:SS 3 : dd/MM/yyyy HH:MM:SS

Allowable Values:

25

CurrencyCode

string

Optional

Currency Code Place Holder for Future Use. Valid Values: Refer Appendix Section - Currency Code Example:840 = US Dollar Condition:If no value is passed, default value = 840

Allowable Values:

10

CurrencySymbolType

string

Optional

Place Holder for Future Use. CurrencySymbolType: 1: Currency Sign like $ 2: 3 ALPHA Currency Code like USD

Allowable Values:

10

Language

string

Optional

Place Holder for Future Use. Language: en: means use English Default: en - English

Allowable Values:

10

ExternalIP

string

Mandatory

IP Address of end user of API

Allowable Values:

50

SessionID

string

Optional

Session identifier of the API Example: 000028;026;1349906692

Allowable Values:

100

APIVersion

string

Mandatory

Version of the API to be invoked. Example: 2.0 API Version Current Version 2.0

Allowable Values:

10

CallerID

string

Optional

Caller ID of source from where API is initiated it is End User Caller ID Example: 7204454214 (phone number applicable in Case of IVR)

Allowable Values:

20

CalledID

string

Optional

Called ID of destination for which API is initiated It is Destination Called ID Example: 7314145404 (phone number applicable in Case of IVR)

Allowable Values:

20

RequestTime

datetime

Optional

Request Date Time of API Format: MM/dd/yyyy HH:mm:ss Example:01/15/2020 10:05:23

AccountNumber

string

Conditional

Account number of Card holder under which secondary card need to be created. Valid Values:0-9 Example:8000000000000037 Condition:At least one account identifier is required.

Allowable Values:

19

AdminNumber

int64

Conditional

Details can be obtained by admin number (Embossing Acctid). Valid Values:0-9 Format:XXXXX Example:12345 Condition:At least one account identifier is required.

VirtualCardLimit

decimal

Conditional

Card limit of Virtual card Valid Values:0-9 Format:XXXX.XX Example:1000.00 Condition:This field is conditional. Virtual Card can be created without passing Virtual card limit, It can be 0 or Null.If it is 0 or Null then card will use Accounts Credit Limit.

VirtualCardResetAllow

integer

Optional

Flag to decide if created virtual card should get the facility to update card limit. Valid Values: 0 = Yes (Will get the facility to update card limit) 1 = No (Will not get the facility to update card limit) Format:X Example:0,1

VirtualCardExpOption

integer

Optional

Virtual card expiration option. Valid Values: 0 = Card expire after no.of transactions. 1 = Card expire on particular duration. 2 = Card expire on particular date. 3 = Card expiry date is same as Primary Card. This field is mandatory when Secondary Card Type is "1"(Virtual). Format: X Example: 2 (Card expire on particular date)

VirtualCardExpAfterTxn

integer

Conditional

Virtual card expiration option after certain number of transaction. Valid Values: 0-9 Format: XX Example: 10 Condition: This field is mandatory when VirtualCardExpOption is 0 (Card expire after no. of transactions)

VirtualCardExpDuration

integer

Conditional

Virtual card expiration duration like hour, minute, day etc Valid Values: 0 = Minutes 1 = Hour 2 = Day 3 = Week 4 = Month 5 = Year Format: X Example: 2 (Day) Condition: This field is mandatory when VirtualCardExpOption = 1 (Card expire on particular duration)

VirtualCardExpDurationValue

integer

Conditional

Virtual card expiration Duration Value. Valid Values: 0-9 Format: XXX Example: Virtual Card Expiry duration is 4(month) then this field value can be of 1-12. Condition: This field is mandatory when VirtualCardExpOption = 1 (Card expire on particular duration)

VirtualCardExpDate

datetime

Conditional

Virtual card expiration option at exact date. Valid Values: 0-9 Format: MM/DD/YYYY Example: 01/01/2024 Condition: This field is mandatory when VirtualCardExpOption is 2 (Card expire on particular date)

IdentifierToken

string

Conditional

A generated token that is not expired can be used as an input field to access API. If we are passing this field in input, user should not pass any other account identifier. Condition:At least one account identifier is required.

Allowable Values:

800

CardImageID

string

Optional

Art/Template ID based on this Card’s Image will be displayed. Valid Values:0-9, a-z Format:XXXX(String) Example:30abc

Allowable Values:

100

VirtualCardAutoReset

integer

Conditional

Flag to decide if Virtual Card Limit will get auto-reset or not. Valid Values: 0 = Yes (Virtual Card Limit will be Auto-Reset) 1 = No(Virtual Card Limit will not be Auto-Reset) Format: X Example: 0,1 Condition: Allowed only if- 1. Virtual Card Limit has a value except 0 or NULL. 2. ‘Usage Reset Frequency’ is set to Billing Cycle at Product Level. 3. If no value is passed, then by default null will be considered as no auto-reset applicable.

Sample request body
{
  "Source": "Web",
  "IPAddress": "10.120.0.1",
  "DateFormat": null,
  "CurrencyCode": null,
  "CurrencySymbolType": null,
  "Language": null,
  "ExternalIP": "10.120.0.0",
  "SessionID": null,
  "APIVersion": "2.0",
  "CallerID": null,
  "CalledID": null,
  "RequestTime": null,
  "AccountNumber": "9000000500000170",
  "AdminNumber": 129408,
  "VirtualCardLimit": 1000.0,
  "VirtualCardResetAllow": 0,
  "VirtualCardExpOption": 3,
  "VirtualCardExpAfterTxn": null,
  "VirtualCardExpDuration": null,
  "VirtualCardExpDurationValue": null,
  "VirtualCardExpDate": null,
  "IdentifierToken": null,
  "CardImageID": null,
  "VirtualCardAutoReset": 1
}
Response fields details
Fields Description

VirtualCardNumber

string

Virtual Card Number Valid Values: 0-9 Format:XXXXXXXXXXXXXXXX Example:1236547896325874

Allowable Values:

19

AccountNumber

string

Account number of Card holder under which secondary card created. Valid Values:0-9 Format:XXXXXXXXXXXXXXXX Example:8000000000000037

Allowable Values:

19

AdminNumber

int64

Details can be obtained by admin number (Embossing Acctid). Valid Values:0-9 Format:XXXXX Example:12345

CurrentCardBalance

decimal

Available Balance of Card. Valid Values:0-9 Format:XXX.XX Example:2000.00

FirstName

string

Card holder's First name. Example:John

Allowable Values:

50

LastName

string

Card holder's last name. Example:Smith

Allowable Values:

50

NameOnCard

string

Name to be printed on the card. Valid Values:A-Z, 0-9 Format:XXXX Example:John J

Allowable Values:

50

PrimaryCardExpiryDate

datetime

Expiry date of primary card under which secondary card is being created. Valid Values:0-9 Format: MM/DD/YYYY HH:MM:SS Example: 01/01/2020 11:05:05

ValidFrom

datetime

Card Creation Date of requested card. Format:MM/dd/yyyy HH:mm:ss Example:01/01/2020

ValidTo

datetime

Card Expiration Date of requested card. Format:MM/dd/yyyy HH:mm:ss Example:01/01/2022

CVC

string

3 Digit security number printed on back side of the card. Valid Values:0-9 Format:XXX Example:456

Allowable Values:

3

VirtualCardExpirationDate

datetime

Card Expiration Date of Virtual card. Valid Values: 0-9 Format: MM/DD/YYYY HH:MM:SS Example: 01/01/2020 11:05:05

Sample response body

{
  "Message": "Card created successfully.",
  "Status": true,
  "ErrorCode": "ERR01070",
  "ResponseData": {
    "VirtualCardNumber": "XXXXXXXXXXXXXXXX",
    "AccountNumber": "7000000000000146",
    "AdminNumber": 129475,
    "CurrentCardBalance": 1000.0,
    "FirstName": "John",
    "LastName": "Miller",
    "NameOnCard": "John Miller",
    "PrimaryCardExpiryDate": "11/02/2022",
    "ValidFrom": "11/02/2020",
    "ValidTo": "11/02/2022",
    "CVC": "XXX",
    "VirtualCardExpirationDate": "11/02/2020"
  }
}