triPOS REST API

<back to all web services

CreatePaymentAccountCreditRequest

The following routes are available for this service:
POST/api/v1/paymentAccount/credit[Deprecated] Use /api/v1/paymentAccount instead.
POST/api/v1/paymentAccountCreates a card account token based on the given data.
CreatePaymentAccountCreditRequest Parameters:
NameParameterData TypeRequiredDescription
AddressbodyAddressNoThe cardholder address information for the transaction.
ExpirationMonthbodystringNoThe expiration month.
ExpirationYearbodystringNoThe expiration year.
LaneIdbodyintNoThe lane ID.
PaymentAccountReferenceNumberbodystringNoThe payment account reference 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.
CreatePaymentAccountCreditResponse Parameters:
NameParameterData TypeRequiredDescription
BinValuebodystringNoThe BIN entry that matched the account number.
CardLogobodystringNoThe card logo. Possible values are: Visa, Mastercard, Discover, Amex, Diners Club, JCB, Carte Blanche, Other.
ExpirationYearbodystringNoThe card's expiration year
ExpirationMonthbodystringNoThe card's expiration month
PaymentAccountIdbodystringNothe payment account ID.
PaymentAccountReferenceNumberbodystringNothe payment account reference number.
TerminalIdbodystringNoThe ID of the terminal used during the transaction.
AccountNumberbodystringNoThe credit card number with the value masked except for the last 4.
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 .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/CreatePaymentAccountCreditRequest HTTP/1.1 
Host: booking.pufferdayspa.com 
Content-Type: application/json
Content-Length: length

{"address":{"billingAddress1":"String","billingAddress2":"String","billingCity":"String","billingEmail":"String","billingName":"String","billingPhone":"String","billingPostalCode":"String","billingState":"String","shippingAddress1":"String","shippingAddress2":"String","shippingCity":"String","shippingEmail":"String","shippingName":"String","shippingPhone":"String","shippingPostalCode":"String","shippingState":"String"},"expirationMonth":"String","expirationYear":"String","laneId":0,"paymentAccountReferenceNumber":"String"}

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

{"binValue":"String","cardLogo":"String","expirationYear":"String","expirationMonth":"String","paymentAccountId":"String","paymentAccountReferenceNumber":"String","terminalId":"String","accountNumber":"String","approvalNumber":"String","isApproved":false,"_processor":{"processorLogs":["String"],"processorRawResponse":"String","processorReferenceNumber":"String","processorRequestFailed":false,"processorRequestWasApproved":false,"processorResponseCode":"Unknown","processorResponseMessage":"String","expressResponseCode":"String","expressResponseMessage":"String","hostResponseCode":"String","hostResponseMessage":"String","logs":["String"],"rawResponse":"String"},"statusCode":"None","transactionDateTime":"String","transactionId":"String","merchantId":"String","_errors":[{"userMessage":"String","developerMessage":"String","errorType":"String","exceptionMessage":"String","exceptionTypeFullName":"String","exceptionTypeShortName":"String"}],"_hasErrors":true,"_links":[{"href":"/api/v1/paymentAccount/String","method":"PUT","rel":"paymentAccountCredit"},{"href":"/api/v1/paymentAccount/String","method":"DELETE","rel":"paymentAccountCredit"},{"href":"/api/v1/sale/String","method":"POST","rel":"paymentAccountSale"},{"href":"/api/v1/authorization/String","method":"POST","rel":"paymentAccountAuthorization"},{"href":"/api/v1/refund/String","method":"POST","rel":"paymentAccountRefund"}],"_logs":["String"],"_type":"String","_warnings":[{"developerMessage":"String","userMessage":"String"}]}