Category links

API Links

Merchant Rate Table

The merchant rate table (MRT) governs attributes of the merchant fees, such as the fee calculation basis, fee timing, and fee discounts (if applicable). You can create or update an MRT as per customer need.

Merchant Rate Table

Action: POST

Endpoint: /api/CoreCredit/MerchantManagement/MerchantRateTable

POST /api/CoreCredit/MerchantManagement/MerchantRateTable

Use this API to insert a new merchant rate table or update an existing merchant rate table. The API requires the institution ID, MRTID, merchant rate table, fee type, discount fee timing, fee calculation basis, and other information. The API will also retrieve the stated fee type for any merchant, fee calculation logic, discount timing, and other criteria.

Request fields detail
Fields Description

Source

string

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

Place Holder for Future Use. Currency Code Ex. 840 = US Doller.

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

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

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

UpdateFlag

integer

Mandatory

Indicates whether request is an insert request or update request 1: for Update request 0: for Insert request

InstitutionId

integer

Mandatory

Unique identification number for Institution. Valid Values:0-9 Format:XXXX Example:Fixed value needs to pass which is provided by Corecard.

MRTID

string

Conditional

Merchant rate table ID is mendatory when request is an update request Valid Values:0-9,A-Z Format: XXX Example: 561 Condition: Mandatory when its an update request

Allowable Values:

19

MerchantRateTable

string

Conditional

This tag refers to the Rate table of that plan. Valid Values:A-Z, 0-9 Format:XXXXXX Example:6 Months No Interest if Paid in Full

Allowable Values:

20

MerchantRateParentName

string

Optional

It is used to provide Parent to inherit Merchant Rate Table Valid Values:0-9, A-Z Format: XXXX Example: MRT1

Allowable Values:

20

FeeType

integer

Conditional

Type of Fee included - 0: Discount 1: Participation Valid Values:0,1 Format:X Example:0,1

DiscountFeeTiming

integer

Mandatory

Frequency of Discount Fee- 0: Daily 1: Weekly 2: Cycle 3: Per Transaction Valid Values:0,1,2,3 Format: X Example: 0,1,2,3

FeeCalculationBasis

integer

Mandatory

On what basis the fee will calculated as - 0: Count 1: Amount 2: Both Valid Values:0,1,2 Format: X Example: 0,1,2

VolumeType

integer

Mandatory

Volume Type 0: Daily 1: Weekly Valid Values:0,1 Format: X Example: 0,1

FeeCalculation

string

Conditional

Fee Calculation 0: Percent of volume amount Valid Values:0 Format: X Example: 0

Allowable Values:

20

AmountPerVolume

decimal

Optional

Amount Per Volume Valid Values:0-9 Format: XX.XX Example: 245.22

AmountPerTransaction

decimal

Optional

Amount per transaction. Valid Values:0-9 Format: XX.XX Example: 245.22

TransactionCode

string

Optional

Transaction Code for the posting of Single Transaction. Valid Values: 427248 = Principal Adjustment

Allowable Values:

20

MRTDetailList

array

MRTDetailList
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,
  "UpdateFlag": 0,
  "InstitutionId": 3235,
  "MRTID": "",
  "MerchantRateTable": null,
  "MerchantRateParentName": "",
  "FeeType": 1,
  "DiscountFeeTiming": 0,
  "FeeCalculationBasis": 0,
  "VolumeType": 0,
  "FeeCalculation": "0",
  "AmountPerVolume": 1.0,
  "AmountPerTransaction": 1.0,
  "TransactionCode": "02",
  "MRTDetailList": [
    {
      "FICOScore": 10,
      "FixedRate1": 20.0,
      "FixedRate2": 23.0,
      "FixedRate3": 33.0,
      "FixedRate4": 43.0,
      "FixedRate5": null,
      "TierLimitIndicator": "0",
      "TierMaxBalance1": null,
      "TierMaxBalance2": null,
      "TierMaxBalance3": null,
      "TierMaxBalance4": null
    }
  ]
}
Response fields detail
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

Sample response body 

{
  "application/json": {
    "Message": "MRT Inserted  Successfully",
    "Status": true,
    "ErrorCode": "ERR01158",
    "ResponseData": {
      "ResponseID": "56742560"
    }
  }
}