AIM Web Services

<back to all web services

C2BPostContractRequest

C2BPostContract
Requires active-e Contracts Service.

The following routes are available for this service:
POST, GET/api/C2BPostContract
C2BPostContractRequest Parameters:
NameParameterData TypeRequiredDescription
TeacherIdqueryintegerNoID of the teacher to associate the contract with.
SchoolNamequerystringNoUsed to associate the contract with a school by school name.
AIMSchoolIdquerystringNoUsed to associate the contract with a school by the AIM School ID
StlocquerystringNoUsed to associate the contract with a location by location code.
InstrumentIdqueryintegerNoID of the instrument to associate the contract with.
SkuquerystringNo
DescquerystringNo
RateIdqueryintegerNoThe ID from the C2BGradeGeneric object
RatequeryobjectNo
AccessoryIdListqueryarrayNo
AccessoryListqueryarrayNo
FormInputListqueryarrayNo
CcInfoqueryobjectNo
CustomerInfoqueryobjectNo
CusAcctqueryintegerNo
CatqueryintNo
SubqueryintNo
ReturnTopicbodybool?No
StatusIdbodylong?No
BaseSecureRequest Parameters:
NameParameterData TypeRequiredDescription
TokenHeaderstringNo
DeviceIdHeaderstringNo
AppIdHeaderstringYes
BaseRequest Parameters:
NameParameterData TypeRequiredDescription
ApiKeyheaderstringYesThis is your AIM API Key provided by Tri-Tech
OAuthTokenheaderstringNo
Rate Parameters:
NameParameterData TypeRequiredDescription
PlanCodeformstringNo
Levelformint?No
GradeformstringNo
DownPayformdecimal?No
MoPayformdecimal?No
DownMaintformdecimal?No
MoMaintformdecimal?No
RdfTypeformstringNo
ContractDefaultIdformlong?No
MonthsformintNoThe Number of Months covered by the downpayment
DownLeaseformdecimal?No
MoLeaseformdecimal?No
Accessory Parameters:
NameParameterData TypeRequiredDescription
DescformstringNo
PriceformdecimalNo
TypeformstringNo
CatNumformintNo
SkuformstringNo
Reportformbool?No
FormInput Parameters:
NameParameterData TypeRequiredDescription
KeyquerystringYesField Name of the Input Field
ValuequerystringYesValue of the Input Field.
EncryptedquerybooleanYesWhether or not the field is encryped with the C2B encryption key.
CcInfo Parameters:
NameParameterData TypeRequiredDescription
TokenStrquerystringYesToken returned from processor
CardTypequerystringYesCard Type (VISA, MCARD, AMEX, DSCVR)
LastFourquerystringYesLast four of the card
ExpirationquerystringNoExpiration Date of the Card. (MM/YY)
ReasonOnFilequerystringNoReason the card is on file.
TokenPkqueryintegerNoID of the existing Token Record in AIM, if applicable
PrimaryquerybooleanNoIs this the customer's primary card? Defaults to false.
CustomerInfo Parameters:
NameParameterData TypeRequiredDescription
WebIdqueryintegerYesThe WebId of the customer. Optional.
NamequerystringYesName of the customer.
Addr1querystringNoAddress line 1 of the customer
Addr2querystringNoAddress line 2 of the customer
CityquerystringNoCity of the customer
StquerystringNoState/Province of the customer
ZipquerystringNoZip code of the customer
CountryquerystringNoCountry of the customer
PhonequerystringNoPhone number of the customer
EmailquerystringYesEmail address of the customer. Required.
C2BPostContractResponse Parameters:
NameParameterData TypeRequiredDescription
PaymentRequiredformboolNo
TopicformstringNo
WebRefformstringNo
BaseUrlformstringNo
BaseResponse Parameters:
NameParameterData TypeRequiredDescription
StatusbodyBaseResponseResultNo
BaseResponseResult Parameters:
NameParameterData TypeRequiredDescription
StatusCodebodystringNo
LoginbodystringNo
ErrorCodebodystringNo
ErrorDisplayTextbodystringNo
ErrorMessagebodystringNo
DomainNamebodystringNo
IpAddressbodystringNo

To override the Content-type in your clients, use the HTTP Accept Header, append the .json suffix or ?format=json

To embed the response in a jsonp callback, append ?callback=myCallback

HTTP + JSON

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

POST /api/C2BPostContract HTTP/1.1 
Host: active-ewebservice.biz 
Accept: application/json
Content-Type: application/json
Content-Length: length

{"TeacherId":0,"SchoolName":"String","AIMSchoolId":0,"Stloc":"String","InstrumentId":0,"Sku":"String","Desc":"String","RateId":0,"Rate":{"PlanCode":"String","Level":0,"Grade":"String","DownPay":0,"MoPay":0,"DownMaint":0,"MoMaint":0,"RdfType":"String","ContractDefaultId":0,"Months":0,"DownLease":0,"MoLease":0},"AccessoryIdList":[0],"AccessoryList":[{"Desc":"String","Price":0,"Type":"String","CatNum":0,"Sku":"String","Report":false}],"FormInputList":[{"Key":"String","Value":"String","Encrypted":false}],"CcInfo":{"TokenStr":"String","CardType":"String","LastFour":"String","Expiration":"String","ReasonOnFile":"String","TokenPk":0,"Primary":false},"CustomerInfo":{"WebId":0,"Name":"String","Addr1":"String","Addr2":"String","City":"String","St":"String","Zip":"String","Country":"String","Phone":"String","Email":"String"},"CusAcct":0,"Cat":0,"Sub":0,"ReturnTopic":false,"StatusId":0,"Token":"String","DeviceId":"String","AppId":"String","ApiKey":"String","OAuthToken":"String"}
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: length

{"PaymentRequired":false,"Topic":"String","WebRef":"String","BaseUrl":"String","Status":{"StatusCode":"String","Login":"String","ErrorCode":"String","ErrorDisplayText":"String","ErrorMessage":"String","DomainName":"String","IpAddress":"String"}}