Update MSR
Action: POST
Endpoint: /api/CoreCredit/MerchantManagement/UpdateMSR
Use this API to update details of a merchant, store, or register for an institution based on MSR-level input. A user may update the merchant, store, or register names, as well as address details, bank account numbers, and ACH routing numbers.
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 |
InstitutionID integer Optional |
Unique identification number for Institution. Example:Fixed value needs to pass which is provided by Corecard. |
MSRLevel integer Optional |
Type of Account to be Updated Valid Values: 0 = Merchant,1 = Store,2 = Register Example:1 Allowable Values: 1 |
MSRNumber integer Optional |
Identifier for Merchant/Store/Register Account to be created Valid Values:0-9 Allowable Values: 5 |
ParentMSRNumber integer Optional |
Identifier for Parent account under which Merchant/Store/Register Account to be Updated. Valid Values:0-9 Allowable Values: 5 |
MSRName string Optional |
Name of the Merchant. Valid Values:A-Z,0-9 Example:ABC LLC Allowable Values: 100 |
MerchantDescription string Conditional |
Description of Account Valid Values:A-Z,0-9 Example:ABC LLC Condition : Required for Merchant and Ignored for Stored/Register Allowable Values: 30 |
ContactType integer Optional |
Type of contact of Merchant Valid Values: 0 = None 1 = Billing 2 = Settlement 3 = Administration 4 = Department 5 = Division Example:3 Allowable Values: 50 |
MerchantState string Optional |
State code to which merchant belongs Valid Values:A-Z,0-9 Example:Alabama Allowable Values: 5 |
MSRWorkNumber string Optional |
MSR Work Phone Number Valid Values:0-9 Format:XXXXXXXXX Example:547896865 Allowable Values: 20 |
MSRHomePhone string Optional |
MSR Home Phone Number Valid Values:0-9 Format:XXXXXXXXX Example:547896865 Allowable Values: 20 |
MSRMobilePhone string Optional |
MSR Mobile Phone Number Valid Values:0-9 Format:XXXXXXXXXXXX Example:547896865689 Allowable Values: 20 |
MSRFaxNumber string Optional |
MSR Fax Number Valid Values:0-9 Format:XXXXXXXXXXXX Example:547896865689 Allowable Values: 20 |
MSREmail1 string Optional |
MSR Email1 Format:abc@cc.com Example:user1@gmail.com Allowable Values: 100 |
MSREmail2 string Optional |
MSR Email2 Format:abc@cc.com Example:user1@gmail.com Allowable Values: 100 |
MSRLegalEntityName string Optional |
Name of the Legal Entity Valid Values:A-Z,0-9 Example:ABC LLC Allowable Values: 30 |
MSRDBAName string Optional |
Do Business As Name Valid Values:A-Z,0-9 Example:ABC LLC Allowable Values: 50 |
MSRTaxIdentificationNumber string Optional |
Organization’s Tax Id Number Valid Values:0-9 Format:XXXXXXXXXXXX Example:547896865689 Allowable Values: 25 |
MSRReserveTable integer Optional |
Merchant Reserve Table Account Id Valid Values:0-9 Format:XXXXXXXXXXXX Example:4785 |
MSRACHROUTINGNUMBER string Conditional |
ABA Routing Number Valid Values:0-9 Format:XXXXXX Example:5478968 Allowable Values: 9 |
MSRACHCHECKINGACCNUM string Conditional |
Bank Account Number Valid Values:0-9 Format:XXXXXXXXXXXX Example:547896865689 Condition:Required when SettlementLevel = 0 Allowable Values: 19 |
MSRACHACCNAME string Conditional |
Account Name Condition:Required when SettlementLevel = 0 Allowable Values: 100 |
MSRTermOverrideInd string Optional |
Merchant TermOverride Indicator Allowable Values: 5 |
MSROverrideFeeRate decimal Optional |
Override Fee Rate |
MSROverrideReserveRate decimal Optional |
Override Reserve Rate |
MSRCreditFirstName string Optional |
Credit First Name Allowable Values: 50 |
MSRCreditLastName string Optional |
Credit Last Name Allowable Values: 50 |
MSRCreditWorkPhone string Optional |
Credit Work Phone Valid Values:0-9 Format:XXXXXX Example:5478968 Allowable Values: 20 |
MSRCreditMobilePhone string Optional |
Credit Mobile Phone Valid Values:0-9 Format:XXXXXXXXXXXX Example:547896865689 Allowable Values: 20 |
MSRCreditEmail1 string Optional |
Credit Email 1 Valid Values:A-Z,0-9 Format:abc@cc.com Example:user1@cc.com Allowable Values: 100 |
MSRAccountingFirstName string Optional |
Accounting First Name Allowable Values: 50 |
MSRAccountingLastName string Optional |
Accounting Last Name Allowable Values: 50 |
MSRAccountingWorkPhone string Optional |
Accounting Work Phone Valid Values:0-9 Format:XXXXXXXX Example:54789686 Allowable Values: 20 |
MSRAccountingMobilePhone string Optional |
Accounting Mobile Phone Valid Values:0-9 Format:XXXXXXXXX Example:547896865 Allowable Values: 20 |
MSRAccountingEmail1 string Optional |
Accounting Email1 Valid Values:A-Z,0-9 Format:abc@cc.com Example:user1@cc.com Allowable Values: 100 |
MSRSalesFirstName string Optional |
Sales First Name Allowable Values: 50 |
MSRSalesLastName string Optional |
Sales Last Name Allowable Values: 50 |
MSRSalesWorkPhone string Optional |
Sales Work Phone Valid Values:0-9 Format:XXXXXXXXX Example:547896865 Allowable Values: 20 |
MSRSalesMobilePhone string Optional |
Sales Mobile Phone Valid Values:0-9 Format:XXXXXXXXX Example:547896865 Allowable Values: 20 |
MSRSalesEmail1 string Optional |
Sales Email1 Valid Values:A-Z,0-9 Format:abc@cc.com Example:user1@cc.com Allowable Values: 100 |
MSRSponserID string Optional |
Merchant Sponser ID Allowable Values: 200 |
MSRArrangementID string Optional |
Arrangement ID Allowable Values: 200 |
MSRAccountManagerFirstName string Optional |
Account Manager First Name Allowable Values: 50 |
MSRAccountManagerLastName string Optional |
Account Manager Last Name Allowable Values: 50 |
ParentMSRSalesFirstName string Optional |
Parent Merchant Sales First Name Allowable Values: 50 |
ParentMSRSalesLastName string Optional |
Parent Merchant Sales Last Name Allowable Values: 50 |
MSRExternalCustomerID string Optional |
External CustomerID Allowable Values: 200 |
MSRExternalID string Optional |
External MerchantID Allowable Values: 50 |
MSRPIN string Optional |
Merchant PIN Allowable Values: 200 |
MSREnrollmentDate datetime Optional |
Enrollment Date Format: MM/DD/YYYY HH:MM:SS Example: 01/01/2020 11:05:05 |
MSRCreditLimitInd string Optional |
Credit Limit Indicator Allowable Values: 50 |
MSRCreditLimitMaxAmount decimal Optional |
Credit Limit Max Amount |
MSRDirectBatchInd string Optional |
Direct Batch Indicator Allowable Values: 50 |
MSRApplicationTypeOverride string Optional |
Application Type Override Allowable Values: 50 |
MSRFeeWaiver string Optional |
Fee Waiver Allowable Values: 10 |
MSRFeeDays string Optional |
Fee Days Allowable Values: 200 |
MSRBillingFrequency string Optional |
Billing Frequency Allowable Values: 50 |
MSRGSDInd string Optional |
Merchant GSD Indicator Allowable Values: 200 |
MSRExternalInd string Optional |
External Merchant Indicator Allowable Values: 200 |
MSRExtCompanyID string Optional |
External Company ID Allowable Values: 200 |
MSRConsumerDirectOptIn string Optional |
Consumer Direct Opt-In Allowable Values: 200 |
MSRMemail2 string Optional |
Merchant Email 2 Valid Values:A-Z,0-9 Format:abc@cc.com Example:user1@cc.com Allowable Values: 100 |
MSRContactPhone string Optional |
ContactPhone Valid Values:0-9 Format:XXXXXXXXXXXX Example:547896865689 Allowable Values: 20 |
MSRServiceAreaAddLine1 string Optional |
Service Area Address Line1 Allowable Values: 50 |
MSRServiceAreaAddLine2 string Optional |
Service Area Address Line2 Allowable Values: 50 |
MSRServiceAreaCity string Optional |
Service Area City Allowable Values: 40 |
MSRServiceAreaState string Optional |
Service Area State Allowable Values: 5 |
MSRServiceAreaZip string Optional |
Service Area Zip Allowable Values: 10 |
MSRServiceWebsite string Optional |
Service Website Allowable Values: 300 |
MSRServiceAreaRadius string Optional |
Service Area Radius Allowable Values: 15 |
MSRServiceLocationLongitude string Optional |
Service Location Longitude Allowable Values: 200 |
MSRServiceLocationLatitude string Optional |
Service Location Latitude Allowable Values: 200 |
MSRLogoID string Optional |
ProductID (Logo ID) of Merchant. Allowable Values: 200 |
MSRServiceLocationPoint string Optional |
Service Location Point Allowable Values: 200 |
MSRServiceLocationRadiusMiles string Optional |
Service Location Radius Miles Allowable Values: 15 |
MSRProgram string Optional |
Program (ProductName) Allowable Values: 100 |
MSRVersion string Optional |
Version Allowable Values: 25 |
MSRPolicyIdentifier integer Conditional |
PolicyIdentifier, will result in digits only Ie. 1 or 2. Possible Value: 1=Grandfathered, 2=Standard Condition:Required when MSRLevel = 0 Allowable Values: 1 |
MSRHighLinePolicy integer Conditional |
HighLinePolicy, will result in digits only Ie. 0 or 1. Possible Values: 0 = No, 1 = Yes Condition:Required when MSRLevel = 0 Allowable Values: 1 |
MSRLineAssignmentPolicy integer Optional |
Line Assigned Policy of Merchant Possible Value: 1=Grandfathered, 2=Standard |
MSRWebServicesPassword string Optional |
Merchant Web Services Password. Allowable Values: 120 |
MSRCreationDate datetime Optional |
Merchant Creation Date. Format: MM/DD/YYYY HH:MM:SS Example: 01/01/2020 11:05:05 |
MSRSplitFee integer Optional |
SplitFee for Merchant Settlement 1 = YES (for seperate credit and debit amount) 0 = NO/NULL (for combine credit and debit amount) Allowable Values: 10 |
MSRTemplateID string Optional |
TemplateID of Merchant Offering Template. Example:MOT1001 Allowable Values: 100 |
AddressLine1 string Optional |
Address Line 1 of Merchant. Valid Values:A-Z,0-9 Example:123 HWY Allowable Values: 50 |
AddressLine2 string Optional |
Address Line 2 of Merchant. Valid Values:A-Z,0-9 Example:Park Avenue Allowable Values: 50 |
City string Optional |
City of Merchant Valid Values:A-Z Format:XXXX Example:Atlanta Allowable Values: 40 |
PostalCode string Optional |
Postal Code for merchant address Valid Values:0-9 Format:XXXXXX Example:1234 Allowable Values: 10 |
County string Optional |
County of MSR Valid Values:0-9 Format:XXXXX Example:54789 Allowable Values: 40 |
Country string Optional |
Country Name of the MSR address Example:USA Allowable Values: 5 |
CustomerID string Optional |
Id Number for Contact/Merchant/Store/Register Allowable Values: 100 |
CompanyName string Optional |
Company Name Allowable Values: 50 |
FirstName string Optional |
Card holder's First name. Valid Values:A-Z Example:User Allowable Values: 50 |
LastName string Optional |
Card holder's Last name. Valid Values:A-Z Example:Smith Allowable Values: 50 |
Position integer Optional |
Employment position of the card holder Valid Values: 0 - None 1 - President 2 - Vice 3 - Director 4 - Manager 5 - Administrator Example: 4 |
MerchantCategory string Optional |
Merchant Category Allowable Values: 200 |
ServiceDescription string Optional |
Service Description Allowable Values: 256 |
NetworkName string Optional |
Name of Network from which Merchant needed to be associated Allowable Values: 50 |
NetworkID int64 Optional |
NetworkID of Network from which Merchant needed to be associated Valid Values:0-9 Format:XXXXXXXXXXXX Example:547896865689 |
MTAcode string Optional |
MTA Code will determine if Transaction Authorization is required for the Purchase posted under this Merchant or not Valid Values:"0000" – MTA not applicable, "3000" – MTA Applicable default value should be "0000" Format:XXXX Example:0000 Allowable Values: 4 |
MerchantLogo string Optional |
File Name for the Logo File Valid Values:0-1 A-Z Format:XXXX Example:LogoFile1 Allowable Values: 50 |
TimeToContactFrom string Optional |
Time To Contact From Valid Values:0-1 Format:XXXXXX Example:083045 Allowable Values: 25 |
TimeToContactTo string Optional |
Time To Contact To Valid Values:0-1 Format:XXXXXX Example:063344 Allowable Values: 25 |
SiteURL string Optional |
URL of the site Valid Values:0-1 A-Z Format:XXXX Example:mysite.com/card Allowable Values: 50 |
Motto string Optional |
Motto Valid Values:0-1 A-Z Format:XXXX Example:Be Independent Allowable Values: 30 |
CardActivationURL string Optional |
Card Activation URL Valid Values:0-1 A-Z Format:XXXX Example:Be Independent Allowable Values: 50 |
Disclosure string Optional |
Disclosure Valid Values:0-1 A-Z Format:XXXX Example:Be Independent Allowable Values: 1500 |
WeekDayHours string Optional |
Description: Weekday hours Valid Values:0-9, a-z Example:Weekdays 6 AM to 7 PM PST Allowable Values: 40 |
WeekendHours string Optional |
Description: Weekend hours Valid Values:0-9, a-z Example:Saturday 7 AM to 12 PM PST Allowable Values: 40 |
CardActivationSiteURL string Optional |
Card Activation URL Valid Values:0-1 A-Z Format:XXXX Example:mysite.com/card/activation Allowable Values: 50 |
CardDescription string Optional |
Description of the Card Valid Values:0-1 A-Z Example: Platinum Card Allowable Values: 50 |
NameOnCard string Optional |
Name on the Card Valid Values:0-1 A-Z Example: John Smith Allowable Values: 50 |
ContactNumber string Optional |
Contact Number of the Distribution Partner Valid Values: 0-1 Example: 02245879654 Allowable Values: 11 |
Tran_CompanyID string Optional |
Unique ID of Company Valid Values: 0-9 Example: 1234 Allowable Values: 200 |
Tran_CompanyName string Optional |
Company Name Valid Values: A-Z Example: abc Allowable Values: 50 |
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, "InstitutionID": 3235, "MSRLevel": 1, "MSRNumber": 6000, "ParentMSRNumber": 11607, "MSRName": "M 6000", "MerchantDescription": "M 6000", "ContactType": 1, "MerchantState": "AL", "MSRWorkNumber": null, "MSRHomePhone": null, "MSRMobilePhone": null, "MSRFaxNumber": "45577777", "MSREmail1": "abc@xyz.com", "MSREmail2": null, "MSRLegalEntityName": null, "MSRDBAName": null, "MSRTaxIdentificationNumber": null, "MSRReserveTable": 4785, "MSRACHROUTINGNUMBER": "011000015", "MSRACHCHECKINGACCNUM": "12457857875", "MSRACHACCNAME": null, "MSRTermOverrideInd": null, "MSROverrideFeeRate": null, "MSROverrideReserveRate": null, "MSRCreditFirstName": null, "MSRCreditLastName": null, "MSRCreditWorkPhone": null, "MSRCreditMobilePhone": null, "MSRCreditEmail1": null, "MSRAccountingFirstName": null, "MSRAccountingLastName": null, "MSRAccountingWorkPhone": null, "MSRAccountingMobilePhone": null, "MSRAccountingEmail1": null, "MSRSalesFirstName": null, "MSRSalesLastName": null, "MSRSalesWorkPhone": null, "MSRSalesMobilePhone": null, "MSRSalesEmail1": null, "MSRSponserID": null, "MSRArrangementID": null, "MSRAccountManagerFirstName": null, "MSRAccountManagerLastName": null, "ParentMSRSalesFirstName": null, "ParentMSRSalesLastName": null, "MSRExternalCustomerID": null, "MSRExternalID": null, "MSRPIN": null, "MSREnrollmentDate": null, "MSRCreditLimitInd": null, "MSRCreditLimitMaxAmount": null, "MSRDirectBatchInd": null, "MSRApplicationTypeOverride": null, "MSRFeeWaiver": null, "MSRFeeDays": null, "MSRBillingFrequency": null, "MSRGSDInd": null, "MSRExternalInd": null, "MSRExtCompanyID": null, "MSRConsumerDirectOptIn": null, "MSRMemail2": null, "MSRContactPhone": null, "MSRServiceAreaAddLine1": null, "MSRServiceAreaAddLine2": null, "MSRServiceAreaCity": null, "MSRServiceAreaState": null, "MSRServiceAreaZip": null, "MSRServiceWebsite": null, "MSRServiceAreaRadius": null, "MSRServiceLocationLongitude": null, "MSRServiceLocationLatitude": null, "MSRLogoID": null, "MSRServiceLocationPoint": null, "MSRServiceLocationRadiusMiles": null, "MSRProgram": null, "MSRVersion": null, "MSRPolicyIdentifier": null, "MSRHighLinePolicy": null, "MSRLineAssignmentPolicy": null, "MSRWebServicesPassword": null, "MSRCreationDate": null, "MSRSplitFee": null, "MSRTemplateID": null, "AddressLine1": "Address Line 1", "AddressLine2": "Address Line 2", "City": "New York", "PostalCode": "45678", "County": null, "Country": "USA", "CustomerID": null, "CompanyName": null, "FirstName": null, "LastName": null, "Position": 4, "MerchantCategory": "1", "ServiceDescription": null, "NetworkName": "Network_2", "NetworkID": 1002, "MTAcode": null, "MerchantLogo": null, "WeekDayHours": null, "WeekendHours": null, "SiteURL": null, "Motto": null, "CardActivationSiteURL": null, "Disclosure": null, "CardDescription": null, "NameOnCard": null, "ContactNumber": null, "Tran_CompanyID": null, "Tran_CompanyName": null }
Response fields details
Fields | Description |
---|---|
ResponseID string |
This number indicates that API responded. Response ID is unique. |
Sample response body
{ "Message": "Request processed successfully", "Status": true, "ErrorCode": "ERR01155", "ResponseData": { "ResponseID": "57324863" } }