triPOS REST API

<back to all web services

ForceRequest

The following routes are available for this service:
GET/api/v1/forceReturns a the list of force endpoints
ForceRequest Parameters:
NameParameterData TypeRequiredDescription
AutoRentalqueryAutoRentalNoThe auto rental parameters to be passed in for an auto rental transaction. more»
AutoRental Parameters:
NameParameterData TypeRequiredDescription
CustomerNameformstringNoCustomer Name.
AgreementNumberformstringNoAgreement number.
VehicleClassCodeformAutoRentalVehicleClassCode?NoClassification of rental vehicle

Allowable Values

  • Unused
  • Mini
  • Subcompact
  • Economy
  • Compact
  • Midsize
  • Intermediate
  • Standard
  • Fullsize
  • Luxury
  • Premium
  • Minivan
  • Van12Passenger
  • MovingVan
  • Van15Passenger
  • CargoVan
  • Truck12Foot
  • Truck20Foot
  • Truck24Foot
  • Truck26Foot
  • Moped
  • Stretch
  • Regular
  • Unique
  • Exotic
  • TruckSmallMedium
  • TruckLarge
  • SUVSmall
  • SUVMedium
  • SUVLarge
  • SUVExotic
  • FourWheelDrive
  • Special
  • Miscellaneous
NoShowIndicatorformAutoRentalNoShowIndicator?NoNo show indicator. Indicates whether rental vehicle was reserved, but not actually rented.

Allowable Values

  • NotApplicable
  • NoShow
AdjustmentDataformAutoRentalAdjustmentDataNoData related to any auto rental adjustments.
PickupDataformAutoRentalPickupDataNoData related to autorental pickup.
ReturnDataformAutoRentalReturnDataNoData related to autorental return.
DailyRentalRateformdecimalNoRate charged per day Visa/MC – Daily rate required for Corp T&E rate III.
WeeklyRentalRateformdecimalNoRate charged per week Visa/MC – Weekly rate required for Corp T&E rate III.
InsuranceChargesformdecimalNoIf insurance is charged, the insurance amount should be provided.
AutoRentalBasic Parameters:
NameParameterData TypeRequiredDescription
DurationformintNoThe number of rental days. Value should be between 0 and 99. Set to 01 for no show rentals.
AutoRentalAdjustmentData Parameters:
NameParameterData TypeRequiredDescription
AmountformdecimalNoAdjustment amount.
CodeformAutoRentalAuditAdjustmentCode?NoIndicates if adjustment for mileage, fuel, vehicle damage, etc. was made to a rental agreement.

Allowable Values

  • NoAdjustments
  • MultipleAdjustments
  • OneAdjustmentCardmemberNotified
  • OneAdjustmentCardmemberNotNotified
ExtraChargesDetailformAutoRentalExtraChargesDetail[]NoPass in up to 6 values that describe the extra charges. For an empty or invalid value, this parameter defaults to NoExtraCharge.

Allowable Values

  • NoExtraCharge
  • Gasoline
  • ExtraMileage
  • LateReturn
  • OneWayServiceFee
  • ParkingOrMovingViolation
AutoRentalPickupData Parameters:
NameParameterData TypeRequiredDescription
CityformstringNoAuto rental pickup city.
CountryCodeformstringNoCountry code where vehicle was picked up. For US, use 840.
DateformstringNoreturn date in yyyy-MM-ddTHH:mm:ss format.
LocationformstringNoName of business where vehicle was picked up.
StateformstringNoAbbreviation of state, province, or other country subdivision where vehicle was picked up.
AutoRentalReturnData Parameters:
NameParameterData TypeRequiredDescription
CityformstringNoAuto rental return city.
CountryCodeformstringNoCountry code where vehicle was returned. For US, use 840.
DateformstringNoreturn date in yyyy-MM-ddTHH:mm:ss format.
LocationIdformstringNoAuto Rental location ID where vehicle was returned.
StateformstringNoAuto rental return state.
DistanceformintNoNumeric distance traveled during rental period.
DistanceUnitformAutoRentalDistanceUnit?NoUnit of measurement applicable to distance traveled.

Allowable Values

  • 0 = Unused
  • 1 = Miles
  • 2 = Kilometers
ApiResponse Parameters:
NameParameterData TypeRequiredDescription
ErrorsformList<ApiError>NoA list of errors that occurred.
HasErrorsformboolNoIndicates if there are errors.
LinksformIEnumerable<ApiLink>NoA list of resource links
LogsformList<string>NoA list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.
TypeformstringNoThe type of object held in the result.
WarningsformList<ApiWarning>NoA list of warnings that occurred.
ApiError Parameters:
NameParameterData TypeRequiredDescription
UserMessageformstringNoAn error message targeted at the end user of the integrated business application.
DeveloperMessageformstringNoAn error message targeted at the developer of the integrated business application.
ErrorTypeformstringNoCode associated with the error if it exists.
ExceptionMessageformstringNoThe body of the exception message.
ExceptionTypeFullNameformstringNoThe full name of the exception.
ExceptionTypeShortNameformstringNoThe short name of the exception.
ApiLink Parameters:
NameParameterData TypeRequiredDescription
HrefformstringNoA target (a URI)
MethodformstringNoThe HTTP method to access the HREF target
RelationformstringNoThe relation aka. 'rel' (the name of the link)
ApiWarning Parameters:
NameParameterData TypeRequiredDescription
DeveloperMessageformstringNoA warning message targeted at the developer of the integrated business application.
UserMessageformstringNoA warning message targeted at the end user of the integrated business application.

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 /json/reply/ForceRequest HTTP/1.1 
Host: triposqa.vantiv.com 
Content-Type: application/json
Content-Length: length

{"autoRental":{"CustomerName":"String","AgreementNumber":"String","VehicleClassCode":"Unused","NoShowIndicator":"NotApplicable","AdjustmentData":{"Amount":0,"Code":"NoAdjustments","ExtraChargesDetail":["NoExtraCharge"]},"PickupData":{"City":"String","CountryCode":"String","Date":"String","Location":"String","State":"String"},"ReturnData":{"City":"String","CountryCode":"String","Date":"String","LocationId":"String","State":"String","Distance":0,"DistanceUnit":"Unused"},"DailyRentalRate":0,"WeeklyRentalRate":0,"InsuranceCharges":0,"Duration":0}}
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: length

{"_errors":[{"userMessage":"String","developerMessage":"String","errorType":"String","exceptionMessage":"String","exceptionTypeFullName":"String","exceptionTypeShortName":"String"}],"_hasErrors":true,"_links":[{"href":"/api/v1/force/credit","method":"POST","rel":"forceCredit"}],"_logs":["String"],"_type":"String","_warnings":[{"developerMessage":"String","userMessage":"String"}]}