Get Account Balance
Action: POST
Endpoint: /api/CoreCredit/AccountManagement/GetAccountBalance
Use this API to retrieve information related to account balances, such as current balance, available reward balance, last payment amount and date, total amount due, and beginning reward balance.
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 |
AdminNumber int64 Conditional |
Details can be obtained by admin number (Embossing Acctid). Valid Values: 0-9 Example: 12345 Condition: At least one of AccountNumber or AdminNumber is required. |
AccountNumber string Conditional |
Card Holder's Account number. Valid Values: 0-9 Format: XXXXXXXXXXXXXXXX Example: 8000000000000037 Condition: At least one of AccountNumber or AdminNumber is required. Allowable Values: 19 |
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": "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": null, "AdminNumber": 61992, "IdentifierToken": null }
Response fields details
Fields | Description |
---|---|
TotalAmountDue decimal |
Total amount due as on statement date. Example: 200.00 |
CurrentBalance decimal |
Current balance of account. Example: 200.00 |
PaymentDueDate datetime |
Due date as to by when payment needs to be made to avoid late fees. Format: MM/dd/yyyy HH:mm:ss Example: 01/25/2020 00:00:00 |
LastPaymentAmount decimal |
Last payment amount on the account. Example: 200.00 |
LastPurchaseAmount decimal |
Last Purchase Amount as on statement date. Example: 200.00 |
RecentPurchasesAndDebits decimal |
Purchase and Debits made on current statement recently. Example: 200.00 |
RecentPaymentsAndCredits decimal |
Payments and Credits made on current statement recently. Example: 200.00 |
LastStatementBalance decimal |
Balance of previous statement. Example: 200.00 |
NextStatementDate datetime |
Next Date for Statement Generation. Format: MM/dd/yyyy HH:mm:ss Example: 01/25/2020 00:00:00 |
CreditLimit decimal |
Total Credit Limit on account. Example: 200.00 |
MaskedCardNumber string |
Masked Card Number. Format: XXXX XXXX XXXX XXXX Example: 4567 89XX XXXX 0123 Allowable Values: 19 |
AvailableCreditLimit decimal |
Total Credit limit minus the total amount due. Example: 200.00 |
LastPaymentDate datetime |
Date of last payment transaction. Format: MM/dd/yyyy HH:mm:ss Example: 01/25/2020 00:00:00 |
PreviousStatementDate datetime |
Date of Previous Statement. Format: MM/dd/yyyy HH:mm:ss Example: 01/25/2020 00:00:00 |
BeginningRewardBalance decimal |
Reward balance at the beginning of Statement. Example: 200.00 |
RewardEarned decimal |
Reward Earned in statement Cycle. Example: 200.00 |
RewardRedeemed decimal |
Reward points Redeemed in statement Cycle. Example: 200.00 |
AvailableRewardBalance decimal |
Number of Available Reward Balance. Example: 200.00 |
RewardExpired decimal |
Number of Expired Rewards. Example: 200.00 |
RewardForfeited decimal |
Number of Forfeited Rewards. Example: 200.00 |
CustomerID string |
This tag reflects the customer ID. Example: 12345 Allowable Values: 50 |
CardNumberLast4Digit string |
Last 4 digits of card number. Example: 1234 Allowable Values: 4 |
CardStatus string |
This tag reflects the status of the card. Example: Active Allowable Values: 50 |
CurrencySymbol string |
This tag reflects the currency symbol |
Sample response body
{ "Message": "Success", "Status": true, "ErrorCode": "Err00017", "ResponseData": { "TotalAmountDue": 0.0, "CurrentBalance": 1000.0, "PaymentDueDate": null, "LastPaymentAmount": 0.0, "LastPurchaseAmount": 0.0, "RecentPurchasesAndDebits": 0.0, "RecentPaymentsAndCredits": 0.0, "LastStatementBalance": 0.0, "NextStatementDate": "03/23/2020 00:00:00", "CreditLimit": 1500.0, "AllotedCardCashUsageLimit": 0.0, "UtilizedCardCashUsageLimit": 0.0, "RemainingCardCashUsageLimit": 0.0, "RemainingCardUsageLimit": 0.0, "UtilizedCardUsageLimit": 0.0, "AllotedCardUsageLimit": 0.0, "EmbossingManualStatus": 0, "MaskedCardNumber": "461668XXXXXX1592", "AvailableCreditLimit": 1500.0, "LastPaymentDate": null, "PreviousStatementDate": null, "BeginningRewardBalance": 0.0, "RewardEarned": 0.0, "RewardRedeemed": 0.0, "AvailableRewardBalance": 0.0, "RewardExpired": 0.0, "RewardForfeited": 0.0, "CustomerID": "44570", "CardNumberLast4Digit": "1592", "CardStatus": "Active", "IsAutoPay": null, "IsPaperless": null, "ESecCardType": null, "VirtualCardReplacementAllowed": null } }