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
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" } } }