Category links

API Links

Manage Bank Accounts

Action: POST

Endpoint: /api/CoreCredit/AccountManagement/ManageBankAccounts

Use this API to manage the bank accounts such as to add or to delete or to update the existing bank account details against a card account. API input should be provided as card number or admin number or account number along with mandatory fields bank account type and request type.

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 cardholder. Valid Values:0-9 Format:XXXXXXXXXX Example:7314145404 Condition:At least one of CardNumber/AdminNumber/AccountNumber 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 of CardNumber/AdminNumber/AccountNumber is required.

CardNumber

string

Conditional

Card Number of account holder Valid Values:0-9 Format:XXXXXXXXXXXXXXXX Example:1236547896541236 Condition:At least one of CardNumber/AdminNumber/AccountNumber is required.

Allowable Values:

19

BankAccountType

integer

Optional

Type of Bank account added by customer for card payment,0=checking and 1=saving Valid Values:0,1 Format:X Example:0,1

BankAccountNumber

string

Conditional

Bank Account Number Valid Values:00000001234567891 Format:XXXXXXXXXXXXXXXXX Example:00000001234567891 Condition:Mandatory when Request Type is 0 i.e Add.

Allowable Values:

17

BankRoutingNumber

string

Conditional

Bank Rrouting number identifies the location of the bank's branch Valid Values:111000038 Format:XXXXXXXXX Example: 111000038 Condition:Mandatory when Request Type is 0 i.e Add.

Allowable Values:

9

BankName

string

Conditional

Name of the Bank Valid Values: A-Z Format:XXXXXXXXXX Example:ABC Corporation Condition:Mandatory when Request Type is 0 i.e Add.

Allowable Values:

100

CreditBalanceRefund

integer

Optional

Flag to tag the bank account for credit balance refund ,Only and Only one Bank Account can be 1 (Yes) of an Account. Valid Values:0-No, 1-Yes. Example: 1

RequestType

string

Optional

Request Type defines the action to be perform in Bank Account. Possible value would be (0 : Add, 1 : Delete, 2 : Update) Valid Values:0 Add 1 Delete 2 Update Format:X

MethodName

int64

Conditional

Method Name uniquely identifies bank accounts in Core card system. Whenever user adds any bank account. Required if request type = 1 or 2 (Update or delete request.) Valid Values:0-9 Format:XXXX Example:4092

ApplicantType

integer

Optional

Selects the type of Applicants. Valid Values: 1,2,3 Example: 1='Applicant', 2 ='Co-Applicant', 3='Cosigner'

UniqueId

string

Optional

Unique ID is a transaction specific unique ID. This ID is unique for every transaction. If multiple calls are made by client for a specific transaction, the value of this tag will always be the same for a specific transaction. (GUID and UUID datatypes are supported for this tag). Valid Values: A-Z, 0-9 Example: F965C56F-C58F-EC11-B80E-A4BF010A357E Condition:For API user, if API Idempotency Applicable is set as Yes on CoreCredit, field is mandatory. The UniqueId is valid for 7 days from first submission of the request. Same request can be retried for 7 days without performing the same action twice.Idempotency will be checked at the belongingOwning Partner and Merchant Level.

Allowable Values:

40

OverrideBankVerificationMethod

integer

Optional

Value in this tag will override the default Program set up of bank verification method. If blank, then default Program level set up will be honoured. Valid Values: 0=None, 1=PreNote, 2=MicroDeposit, 3=ThirdPartyValidation Example: 0

Sample request body
{
  "Source": "Web",
  "IPAddress": "10.120.0.0",
  "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": "5000000000012186",
  "AdminNumber": 95957,
  "CardNumber": null,
  "BankAccountType": 0,
  "BankAccountNumber": "2011474202",
  "BankRoutingNumber": "022309611",
  "BankName": "testbank",
  "CreditBalanceRefund": 1,
  "RequestType": "0",
  "MethodName": null,
  "ApplicantType": null,
  "UniqueId": null,
  "OverrideBankVerificationMethod": null
}
Response fields details
Fields Description

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

MethodName

int64

Method Name uniquely identifies bank accounts in Core card system. Whenever user adds any bank account. Required if request type = 1 or 2 (Update or delete request.) Valid Values:0-9 Format:XXXX Example:4092

Sample response body

{
  "Message": "Bank Account Management Added",
  "Status": true,
  "ErrorCode": "ERR01004",
  "ResponseData": {
    "ResponseID": "56812588",
    "MethodName": 3241
  }
}