Category links

API Links

Hold Payment Details

Action: POST

Endpoint: /api/CoreCredit/AccountManagement/HoldPaymentDetails

Use this API to verify hold or released payment status. The API fetches details such as payment transaction ID, hold amount, rule name, payment hold days, hold status (On-Hold, Released Automatically, Released Manually, Payment Reversal), total number of payments on hold, total amount of payments placed on hold, payment transaction ID, and payment hold release date in an array (Hold Payment Details) form. A user may obtain the details of a specific payment by providing the payment transaction ID or all  payments for a given card number, account number, or admin number.

Note

This service additionally provides the option to get the payment transactions based on the status.

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 Account identifier input parameter should be passed.

Allowable Values:

19

TransactionID

string

Conditional

Transaction ID of the payment for which the details are being retrieved. Valid Values:0-9 Format:XXXXXXXXXXXXXXXX Example:23654789 Condition:At least one Account identifier input parameter should be passed.

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 input parameter should be passed.

CardNumber

string

Conditional

Card Number of account holder. Valid Values:0-9 Format:XXXXXXXXXXXXXXXX Example:1236547896541236 Condition:At least one Account identifier input parameter should be passed.

Allowable Values:

19

AccountID

integer

Conditional

Account ID represents Unique Identity of Account (CoreCard Bsegment Entitity, i.e., the Account ID of program card account). Format:XXXXX Example:12345

BatchSize

integer

Optional

Number of Transaction which can be view in one Batch Default Value would be 50. Valid Values:0-9 Format:XX Example:20

PageIndex

integer

Optional

Number of page Default value would be 0 Valid Values:0-9 Format:XX Example:12

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,
  "AccountNumber": "9000000500000097",
  "TransactionID": "",
  "AdminNumber": null,
  "CardNumber": "",
  "BatchSize": null,
  "PageIndex": null
}
Response fields details
Fields Description

AccountNumber

string

Account number of cardholder. Valid Values:0-9 Format:XXXXXXXXXX Example:7314145404

Allowable Values:

19

HoldPaymentDetails

array

HoldPaymentDetails

TotalPaymentOnHold

decimal

Total or cumulative number of payments on hold. Valid Values:0-9 Format:XX Example:2

TotalAmountOnHold

decimal

Total or cumulative amount of payments on hold. Valid Values:0-9 Format:XXX.XX Example:245.23

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.

Allowable Values:

15

Sample response body

{
  "Message": "Hold Payment Displayed Successfully",
  "Status": true,
  "ErrorCode": "ERR01118",
  "ResponseData": {
    "AccountNumber": "9000000500000097",
    "HoldPaymentDetails": [
      {
        "PaymentTransactionID": "123372036854813850",
        "ScheduleID": 0,
        "HoldAmount": 50.0,
        "PaymentPostTime": "01/16/2017 00:00:00",
        "HoldReleaseDate": "01/23/2017 00:00:00",
        "PaymentHoldRuleName": "Ach payment hold",
        "TransactionCode": "37221 = AUTO ACH PAYMENT",
        "HoldStatus": "1",
        "MediumRiskRule": null,
        "HighRiskRule": null
      }
    ],
    "TotalPaymentOnHold": 0.0,
    "TotalAmountOnHold": 0.0,
    "ResponseID": null
  }
}