The MCASuite REST API allows other systems to integrate into MCA Suite through a HTTP RESTful web service.  The API is designed to ease the painful process of hand entering data from one system to another system.  All responses will be in JSON format.  If you are adding more than 25 transactions at once, we suggest you use the bulk AddTransactions API.
 
Login
 
All calls require two identifying header parameters for credentialing:

1.    X_MCASUITE_APP_ID
2.    X_MCASUITE_APP_TOKEN

Both of these values will be generated by MCA Suite and provided to our customers. Please contact your representative to get these credentials. 
 
 
URLS: 
 
The Base REST URL will be provided to the customer upon API request.
 
Format:
 
The API will only accept json encoded parameters.
 
Testing:
 
To test the rest url and parameter, we recommend using the Rested app on Mac OS.  Alternatively, you can use the “Advanced Rest Client” extension on google Chrome.  If using the Chrome extension, please verify you use application/json as content type, and paste the json parameters into the Raw tab.

Adding a Single Transaction
 

When adding a transaction through the rest api, the transaction can be seen under Deal Tracking similar to importing with csv or adding a manual transaction on the page.


Before adding a transaction, you must set up a Collector and a Merchant number on deal tracking page.  This will identify which deal the transaction will be uploaded too.  Alternatively, you can send in the MCA Suite dealId.  


Function:
Name: addTransaction
Type: POST
Parameters: 


Field Name
Required?
Type
Description
collector
Yes
String
The name of the collector company
dateYesStringDate of transaction (MM/dd/yy)
merchantNumber
YesString
Merchant number
dealId
StringAlternative method to match transaction to a deal.
If dealId is used, merchantNumber and collector are ignored

amount

YesDecimal


description

String - Max 30
Recommended.

type

YesString'Upload', 'Fee' or 'Discount'
default is 'Upload' if not supplied
transactionNumber
StringTrans ID
category
StringTransaction Category set up in your Application Configuration.  
Must exist in MCA Suite.  It is case sensitive.
achWorksId
StringOptional for users who use ACH Works and want to lookup a
deal by the ACHWorks front end trace number. This will replace
dealId and collector + merchantNumber.


Return Response


Field Name
TypeDescription
success
Booleantrue/false
error
List List of error messages if available