Category links

API Links

Card Replacement

Action: POST

Endpoint: /api/CoreCredit/CardManagement/CardReplacement

Use this API to replace a card. The card needs to be replaced for various reasons like the card is lost\stolen\damage\other\reissue. The decision flag decides that a new card should be generated with the same card number or old card number. The delivery mechanism and shipping address can also be provided in the input.

Request fields details
Fields Description

QRCode

string

Optional

This tag is to to capture the QR Code image file URL. Valid Values: a-z,0-9 Format: url format Example: https://test/qr/d969e78921

Allowable Values:

50

SignatureID

string

Optional

This tag is to to capture the user signature image file URL. Valid Values: a-z,0-9 Format:url format Example: https://test/qr/d969e78921

Allowable Values:

50

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

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.

Reason

integer

Optional

Reason to identify why we are requesting card replacement. Possible Values: 1- Stolen 2- Lost 3- Damaged(Status will be marked Closed) 9- ReIssue 10- Breach 11- Other 13- Physical Card 14- Virtual Card Replacement 15- Generate New Card Valid Values:0-9 Format:XX Example:1,9

DecisionFlag

integer

Mandatory

Flag to decide if new card need to be generated with different card number or new plastic with same embossing information. 1- New card with different card number 0- New card with same embossing information. Valid Values: 0,1 Format:X Example:1,0

DeliveryMechanism

string

Conditional

Shipment delivery mechanism. By Default Setting must be for standard Delivery and Usually overnight delivery involves card fee in credit environment. (2-Overnight, 1-Priority , 0-Standard) Valid Values: 0,1,2 Format:xxxx Example:0,1,2 3-Standard Exp 4-Priority Exp 5-Overnight Exp Condition:Values 3,4,5 are only applicable for Perfect Plastic Card Vendor

Allowable Values:

9

CardFee

integer

Conditional

Fee on Card Shipment. If the value is 1 then fees will be charged and if this is 0 then fees will not be charged. Valid Values: 0-1 Format:xxxx Example:0,1 Condition:Delivery Mechanism = 2(Overnight) then fees will always be charged

InstantPersonalize

string

Optional

This flag decides if we want to generate a new card or if want to personalize a card from stack. Valid Values: 0,1 Format:xxxx Example:0,1 Condition: Should be 1 when Decision Flag is 1

Allowable Values:

1

ShippingAddressFlag

integer

Optional

This flag decides if we want to ship the new card to existing address or alternate address. Valid Values: 0 = Ship to Existing Address 1 = Ship Address 2 = Primary Shipping Address Format:X Example:2 Condition:Default value would be 2

ShippingAddressCompanyName

string

Conditional

Indicates Company Name for alternate address which need to be added. Valid Values: 0-9,A-z Format:xxxx Example: XYZ Ltd Condition:This is mandatory only when HoldEmbossing tag value is 0(NO) and ShippingAddressFlag as 1 Please refer Appendix Section 5.50 (Vendor wise field length) for field length supported by embossing vendor.

Allowable Values:

50

ShippingAddressContactName

string

Conditional

Indicates shipping Contact Name for alternate address which need to be added, Valid Values: 0-9,A-z Format:xxxx Example:XYZ Condition: This is mandatory only when HoldEmbossing tag value is 0(NO) and ShippingAddressFlag as 1.

Allowable Values:

50

AdditionalAddressLine1

string

Conditional

Indicates shipping AddressLine1 for alternate address which need to be added. Valid Values: 0 - 9, a-z Format: XXXXX Example: XYZ Condition:This is mandatory only when HoldEmbossing tag value is 0(NO) and ShippingAddressFlag as 1. Please refer Appendix Section 5.50 (Vendor wise field length) for field length supported by embossing vendor.

Allowable Values:

50

AdditionalAddressLine2

string

Conditional

Indicates shipping AddressLine2 for alternate address which need to be added. Valid Values: 0 - 9, a-z Format: XXXXX Example: XYZ Condition:This is mandatory only when HoldEmbossing tag value is 0(NO) and ShippingAddressFlag as 1 or Country selected as Non-US. Please refer Appendix Section 5.50 (Vendor wise field length) for field length supported by embossing vendor.

Allowable Values:

50

AdditionalAddressCity

string

Conditional

Indicates shipping Address City for alternate address which need to be added. Valid Values: 0-9 a-z Format:xxxx Example:kansas Condition:This is mandatory only when HoldEmbossing tag value is 0(NO) and ShippingAddressFlag as 1 or Country selected as Non-US. Please refer Appendix Section 5.50 (Vendor wise field length) for field length supported by embossing vendor.

Allowable Values:

25

AdditionalAddressCountry

string

Conditional

Indicates shipping Address Country for alternate address which need to be added. Valid Values:0-9 a-z Format:xxxx Example:USA Condition:This is mandatory only when HoldEmbossing tag value is 0(NO) and ShippingAddressFlag as 1 Please refer Appendix Section 5.50 (Vendor wise field length) for field length supported by embossing vendor.

Allowable Values:

20

AdditionalAddressState

string

Conditional

Indicates shipping Address State for alternate address which need to be added Valid Values: 0-9 a-z Format: xxxx Example: Indiana Condition:This is mandatory only when HoldEmbossing tag value is 0(NO),ShippingAddressFlag as 1 or Country selected as Non-US. Please refer Appendix Section 5.50 (Vendor wise field length) for field length supported by embossing vendor.

Allowable Values:

30

AdditionalAddressPostalCode

string

Conditional

Indicates shipping Address PostalCode for alternate address which need to be added. Valid Values:0-9 Format:xxxx Example:123456 Condition:This is mandatory only when HoldEmbossing tag value is 0(NO),ShippingAddressFlag as 1 or Country selected as Non-US. Please refer Appendix Section 5.50 (Vendor wise field length) for field length supported by embossing vendor.

Allowable Values:

9

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

NameOnCard

string

Optional

Name to be printed on the card. Valid Values:A-Z, 0-9 Format:XXXX Example:John J Condition: Please refer Appendix Section 5.50 (Vendor wise field length) for field length supported by embossing vendor.

Allowable Values:

50

NameOnTrack

string

Optional

Details to be provided in the Magnetic Strip (mostly derived from Last Name and First name of the Card Holder). Valid Values:a-z Format:XXXX Example:John J Condition: Please refer Appendix Section 5.50 (Vendor wise field length) for field length supported by embossing vendor.

Allowable Values:

26

ActivationCode

string

Optional

At the time of Account creation/Registration user provide activation code, Present in Account Parameter accordion which is saved in EmbossingAccounts table. Valid Values: A-Z 0-9 Example: AB12345 Condition: This shall be a mandatory tag, if Card Activation Parameter on product is set as 'Activation Code'. Please refer Appendix Section 5.50 (Vendor wise field length) for field length supported by embossing vendor.

Allowable Values:

50

HoldEmbossing

integer

Optional

Hold Embossing indicator. Valid Values:1= YES, 0 = NO Format: X Example: 1

FirstName

string

Optional

Card holder's First name. Valid Values:A-Z Format:XXXXX Example:User1 Condition: Please refer Appendix Section 5.50 (Vendor wise field length) for field length supported by embossing vendor.

Allowable Values:

50

LastName

string

Optional

Card holder's last name. Valid Values:A-Z Format:XXXXX Example:Smith Condition: Please refer Appendix Section 5.50 (Vendor wise field length) for field length supported by embossing vendor.

Allowable Values:

50

MiddleName

string

Optional

Card holder's Middle Name Valid Values: A-Z Format:XXX Example: LEE Condition: Please refer Appendix Section 5.50 (Vendor wise field length) for field length supported by embossing vendor.

Allowable Values:

50

ReplacementOriginalCardStatus

integer

Optional

Indicates the Status of the original card when request of card replacemnet is made. Possible values are : 1 = Close Existing Card Immediately 3 = Close Existing When New Card Is Activated Default value is 3- Close Existing When New Card Is Activated Valid Values: 1,3 Format: X Example: 1,3

ReplacementOriginalCardAction

integer

Optional

Indicates the Replacement Original Card Action Possible values are 1 = Cancel 2 = Closed Default value is 1(Cancel) Valid Values: 1,2 Format: X Example: 1,2

QRCode

string

Optional

This tag is to to capture the QR Code image file URL. Valid Values: a-z,0-9 Format: url format Example: https://test/qr/d969e78921

Allowable Values:

50

SignatureID

string

Optional

This tag is to to capture the user signature image file URL. Valid Values: a-z,0-9 Format:url format Example: https://test/qr/d969e78921

Allowable Values:

50

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

Sample request body
{
  "Source": "Web",
  "IPAddress": null,
  "DateFormat": null,
  "CurrencyCode": null,
  "CurrencySymbolType": null,
  "Language": null,
  "ExternalIP": "10.205.0.56",
  "SessionID": null,
  "APIVersion": "2.0",
  "CallerID": null,
  "CalledID": null,
  "RequestTime": null,
  "AdminNumber": 5666,
  "Reason": 2,
  "DecisionFlag": 0,
  "DeliveryMechanism": "0",
  "CardFee": 0,
  "InstantPersonalize": null,
  "ShippingAddressFlag": 0,
  "ShippingAddressCompanyName": "isc",
  "ShippingAddressContactName": "John",
  "AdditionalAddressLine1": "Address123",
  "AdditionalAddressLine2": "Add2",
  "AdditionalAddressCity": "Alaska",
  "AdditionalAddressCountry": "US",
  "AdditionalAddressState": "AK",
  "AdditionalAddressPostalCode": "46321",
  "CardImageID": null,
  "NameOnCard": null,
  "NameOnTrack": null,
  "ActivationCode": null,
  "HoldEmbossing": null,
  "FirstName": null,
  "LastName": null,
  "MiddleName": null,
  "ReplacementOriginalCardStatus": null,
  "ReplacementOriginalCardAction": null,
  "QRCode": null,
  "SignatureID": null,
  "IdentifierToken": null
}
Response fields details
Fields Description

MaskCardNumber

string

Masked number of the newly generated card. Valid Values:0-9 Format:XXXXXXXXXX Example:7314145404

Allowable Values:

19

AdminNumber

int64

Admin Number of the newly generated card and this field will populated only when request creating new embossing. Valid Values:0-9 Format:XXXXX Example:12345

CardExpirationDate

string

Card Expiration Date of requested card Valid Values: 0-9 Format: MMYY Example: 0119

CVV

string

This tag refer the CVV of the card Valid Values:0-9 Format:XXX Example:123

Allowable Values:

3

ResponseID

string

This number indicates that API responded.Response ID is unique.This value will be null if no authentication information was passed. Response ID can be used for tracking Valid Values:0-9,a-z Format:xxx Example:200

Allowable Values:

20

ManualCardStatus

string

Card Status when request creating new embossing Valid Values:0-9 Format:XXXXX Example:12345

Allowable Values:

50

OriginalAdminNumber

int64

Admin number of the original old card. Valid Values:0-9 Format:XXXXX Example:12345

OldCardManualStatus

string

Manual status of the old card. Valid Values: 0-9,a-z Format:XXXXX Example:Active,pending

Allowable Values:

50

MaskCardNumber

string

Masked number of the newly generated card. Valid Values:0-9 Format:XXXXXXXXXX Example:7314145404

Allowable Values:

19

AdminNumber

int64

Admin Number of the newly generated card and this field will populated only when request creating new embossing. Valid Values:0-9 Format:XXXXX Example:12345

CardExpirationDate

string

Card Expiration Date of requested card Valid Values: 0-9 Format: MMYY Example: 0119

CVV

string

This tag refer the CVV of the card Valid Values:0-9 Format:XXX Example:123

Allowable Values:

3

ResponseID

string

This number indicates that API responded.Response ID is unique.This value will be null if no authentication information was passed. Response ID can be used for tracking Valid Values:0-9,a-z Format:xxx Example:200

Allowable Values:

20

CardStatus

string

status of the new card Valid Values:0-9,a-z Format:XXXXX Example:Active,pending

Allowable Values:

50

OriginalAdminNumber

int64

Admin number of the original old card. Valid Values:0-9 Format:XXXXX Example:12345

OldCardStatus

string

status of the old card Valid Values: 0-9,a-z Format:XXXXX Example:Active,pending

Allowable Values:

50

Sample response body

{
  "Message": "Request accepted: Card reported as Lost / Stolen",
  "Status": true,
  "ErrorCode": "ERR01080",
  "ResponseData": {
    "MaskCardNumber": null,
    "AdminNumber": null,
    "CardExpirationDate": null,
    "CVV": null,
    "ResponseID": null,
    "CardStatus": null,
    "OriginalAdminNumber": null,
    "OldCardStatus": null
  }
}