triPOS REST API

<back to all web services

PaymentAccountSaleRequest

The following routes are available for this service:
POST/api/v1/sale/{paymentAccountId}Creates a new payment account sale based on the passed in amounts.
PaymentAccountSaleRequest Parameters:
NameParameterData TypeRequiredDescription
PaymentAccountIdpathstringYesThe payment account ID.
AddressbodyAddressNoThe cardholder address information for the transaction.
ConfigurationbodyRequestConfigurationNoAny value included in this section will override the corresponding value set in the triPOS.config
ConvenienceFeeAmountbodydecimalNoThe convenience fee amount of the transaction. This amount is added to the TotalAmount before the cardholder is charged
TipAmountbodydecimalNoThe tip amount of the transaction. This amount is added to the TotalAmount before the cardholder is charged.
TransactionAmountbodydecimalNoThe total transaction amount. This is the amount of funds to move on the card
LaneIdbodyintNoSpecifies which lane to use for the card sale.
ClerkNumberbodystringNoAn optional clerk number for reference.
ReferenceNumberbodystringNoA user defined reference number. This reference number is returned in the response
ShiftIdbodystringNoAn optional shift id for reference.
TicketNumberbodystringNoAn optional ticket number.
Address Parameters:
NameParameterData TypeRequiredDescription
BillingAddress1bodystringNoThe street address used for billing purposes.
BillingAddress2bodystringNoThe street address used for billing purposes.
BillingCitybodystringNoThe name of the city used for billing purposes.
BillingEmailbodystringNoThe e-mail address used for billing purposes.
BillingNamebodystringNoThe name used for billing purposes.
BillingPhonebodystringNoThe phone number used for billing purposes. The recommended format is (800)555-1212.
BillingPostalCodebodystringNoThe postal code used for billing purposes.
BillingStatebodystringNoThe name of the state used for billing purposes. This value may be any 2 character state code or the full state name.
ShippingAddress1bodystringNoThe street address used for shipping purposes.
ShippingAddress2bodystringNoThe street address used for shipping purposes.
ShippingCitybodystringNoThe name of the city used for shipping purposes.
ShippingEmailbodystringNoThe e-mail address used for shipping purposes.
ShippingNamebodystringNoThe name used for shipping purposes.
ShippingPhonebodystringNoThe phone number used for shipping purposes. The recommended format is (800)555-1212
ShippingPostalCodebodystringNoThe postal code used for shipping purposes.
ShippingStatebodystringNoThe name of the state used for shipping purposes. This value may be any 2 character state code or the full state name.
RequestConfiguration Parameters:
NameParameterData TypeRequiredDescription
AllowPartialApprovalsbodybool?NoIf set to true, partial approvals are allowed
CheckForDuplicateTransactionsbodybool?NoIf set to true, enables duplicate checking logic for the transaction at the host.
CurrencyCodebodyCurrencyCode?NoThe currency code of the transaction.

Allowable Values

  • None
  • Cad
  • Usd
  • Eur
MarketCodebodyMarketCodeNoThe market code of the transaction.

Allowable Values

  • Default
  • AutoRental
  • DirectMarketing
  • ECommerce
  • FoodRestaurant
  • HotelLodging
  • Petroleum
  • Retail
  • Qsr
PaymentAccountSaleResponse Parameters:
NameParameterData TypeRequiredDescription
PaymentAccountIdbodystringNoThe payment account ID.
PaymentAccountReferenceNumberbodystringNoThe payment account reference number.
AvsResponseCodebodystringNoThe AVS response code.
ApprovedAmountbodydecimalNoThe amount approved by the processor. This is the actual amount that will be charged or credited.
CardLogobodystringNoThe card logo. Possible values are: Visa, Mastercard, Discover, Amex, Diners Club, JCB, Carte Blanche, Other.
ConvenienceFeeAmountbodydecimalNoThe convenience fee added to the transaction
SubTotalAmountbodydecimalNoThe original amount sent for the transaction.
TipAmountbodydecimalNoThe tip amount added to the transaction.
TerminalIdbodystringNoThe ID of the terminal used during the transaction
TotalAmountbodydecimalNoThe total amount of the transaction.
ReferenceNumberbodystringNoThe reference number.
BaseResponse Parameters:
NameParameterData TypeRequiredDescription
ApprovalNumberbodystringNoApproval number from the processor. Depending on card type and processor an approval number might not be returned.
IsApprovedbodyboolNoSet to true if the host approved the transaction.
ProcessorbodyProcessorNoResponse information from the processor.
StatusCodebodyTransactionFlowStatusNoThe status code for the transaction.

Allowable Values

  • None
  • Success
  • Declined
  • Approved
  • Restart
  • Failed
  • HostError
  • Timeout
  • FailedVerification
  • CardError
  • UnknownCard
  • UnsupportedCard
  • DeviceError
  • Cancelled
  • ChipError
  • PinPadError
  • PinPadTimeout
  • InvalidLane
  • SwipedCardIsChipCapable
  • ApprovedByMerchant
  • ChipReaderError
  • UseChipReader
  • UseMagneticStripe
  • CardRemoved
  • CardBlocked
  • CardNotSupported
  • BadCard
  • CandidateListEmpty
  • IssuerAuthenticationFailed
  • CardDataEncryptionNotEnabled
  • ApprovedExceptCashback
  • ApplicationBlocked
TransactionDateTimebodystringNoTransaction date/time in ISO8601 format
TransactionIdbodystringNoThe transaction ID from the processor
MerchantIdbodystringNoThe Merchant used to process the transaction.

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

HTTP + XML

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

POST /xml/reply/PaymentAccountSaleRequest HTTP/1.1 
Host: booking.pufferdayspa.com 
Content-Type: application/xml
Content-Length: length

<paymentAccountSaleRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://tripos.vantiv.com/2014/09/TriPos.Api">
  <address>
    <billingAddress1>String</billingAddress1>
    <billingAddress2>String</billingAddress2>
    <billingCity>String</billingCity>
    <billingEmail>String</billingEmail>
    <billingName>String</billingName>
    <billingPhone>String</billingPhone>
    <billingPostalCode>String</billingPostalCode>
    <billingState>String</billingState>
    <shippingAddress1>String</shippingAddress1>
    <shippingAddress2>String</shippingAddress2>
    <shippingCity>String</shippingCity>
    <shippingEmail>String</shippingEmail>
    <shippingName>String</shippingName>
    <shippingPhone>String</shippingPhone>
    <shippingPostalCode>String</shippingPostalCode>
    <shippingState>String</shippingState>
  </address>
  <clerkNumber>String</clerkNumber>
  <configuration>
    <allowPartialApprovals>false</allowPartialApprovals>
    <checkForDuplicateTransactions>false</checkForDuplicateTransactions>
    <currencyCode>None</currencyCode>
    <marketCode>Default</marketCode>
  </configuration>
  <convenienceFeeAmount>0</convenienceFeeAmount>
  <laneId>0</laneId>
  <paymentAccountId>String</paymentAccountId>
  <referenceNumber>String</referenceNumber>
  <shiftId>String</shiftId>
  <ticketNumber>String</ticketNumber>
  <tipAmount>0</tipAmount>
  <transactionAmount>0</transactionAmount>
</paymentAccountSaleRequest>

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: length

<paymentAccountSaleResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://tripos.vantiv.com/2014/09/TriPos.Api">
  <_errors>
    <error>
      <developerMessage>String</developerMessage>
      <errorType>String</errorType>
      <exceptionMessage>String</exceptionMessage>
      <exceptionTypeFullName>String</exceptionTypeFullName>
      <exceptionTypeShortName>String</exceptionTypeShortName>
      <userMessage>String</userMessage>
    </error>
  </_errors>
  <_hasErrors>true</_hasErrors>
  <_links />
  <_logs xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <d2p1:string>String</d2p1:string>
  </_logs>
  <_type>String</_type>
  <_warnings>
    <warning>
      <developerMessage>String</developerMessage>
      <userMessage>String</userMessage>
    </warning>
  </_warnings>
  <_processor>
    <expressResponseCode>String</expressResponseCode>
    <expressResponseMessage>String</expressResponseMessage>
    <hostResponseCode>String</hostResponseCode>
    <hostResponseMessage>String</hostResponseMessage>
    <logs xmlns:d3p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
      <d3p1:string>String</d3p1:string>
    </logs>
    <processorLogs xmlns:d3p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
      <d3p1:string>String</d3p1:string>
    </processorLogs>
    <processorRawResponse>String</processorRawResponse>
    <processorReferenceNumber>String</processorReferenceNumber>
    <processorRequestFailed>false</processorRequestFailed>
    <processorRequestWasApproved>false</processorRequestWasApproved>
    <processorResponseCode>Unknown</processorResponseCode>
    <processorResponseMessage>String</processorResponseMessage>
    <rawResponse>String</rawResponse>
  </_processor>
  <approvalNumber>String</approvalNumber>
  <isApproved>false</isApproved>
  <merchantId>String</merchantId>
  <statusCode>None</statusCode>
  <transactionDateTime>String</transactionDateTime>
  <transactionId>String</transactionId>
  <approvedAmount>0</approvedAmount>
  <avsResponseCode>String</avsResponseCode>
  <cardLogo>String</cardLogo>
  <convenienceFeeAmount>0</convenienceFeeAmount>
  <paymentAccountId>String</paymentAccountId>
  <paymentAccountReferenceNumber>String</paymentAccountReferenceNumber>
  <referenceNumber>String</referenceNumber>
  <subTotalAmount>0</subTotalAmount>
  <terminalId>String</terminalId>
  <tipAmount>0</tipAmount>
  <totalAmount>0</totalAmount>
</paymentAccountSaleResponse>