| POST | /api/v1/force/credit | Creates a new credit card force based on the passed in amounts. |
|---|
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| ApprovalNumber | body | string | No | The approval number of a voice authorization |
| Configuration | body | RequestConfiguration | No | Any value included in this section will override the corresponding value set in the triPOS.config |
| TransactionAmount | body | decimal | No | The total transaction amount. This is the amount of funds to move on the card |
| Lodging | body | LodgingTransactionCompletion | No | The lodging parameters to be passed in for a lodging transaction. more» |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| CardHolderPresentCode | body | CardHolderPresentCode? | No | Defines whether the card holder is present at the transaction. This value is optional, but recommended to be set. If this value is not set in the request, it will be automatically set based on the market code.Allowable Values
|
| ClerkNumber | body | string | No | An optional clerk number for reference. |
| LaneId | body | int | No | Specifies which lane to use. |
| ReferenceNumber | body | string | No | A user defined reference number. This reference number is returned in the response |
| ShiftId | body | string | No | An optional shift id for reference. |
| TicketNumber | body | string | No | An optional ticket number. |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| AllowPartialApprovals | body | bool? | No | If set to true, partial approvals are allowed |
| CheckForDuplicateTransactions | body | bool? | No | If set to true, enables duplicate checking logic for the transaction at the host. |
| CurrencyCode | body | CurrencyCode? | No | The currency code of the transaction.Allowable Values
|
| MarketCode | body | MarketCode | No | The market code of the transaction. Allowable Values
|
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| CustomerName | body | string | No | The lodging customer name. |
| AgreementNumber | body | string | No | The lodging agreement number. |
| CheckInDate | body | string | No | The check-in date for the lodging stay. Must be in the ISO 8601 format of YYYY-MM-DD. |
| CheckOutDate | body | string | No | The check-out date for the lodging stay. Must be in the ISO 8601 format of YYYY-MM-DD. |
| RoomAmount | body | decimal | No | The nightly rate for one room. |
| NoShow | body | bool | No | Set to true to indicate no show. Otherwise, value defaults to false. |
| Duration | body | int | No | The number of hotel stay days. Set to 1 for no show. |
| ExtraChargesDetail | body | LodgingExtraChargesDetail[] | No | Pass in up to 6 values that describe the extra charges. If not passed in, this value defaults to NotUsed.Allowable Values
|
| PrestigiousPropertyCode | body | LodgingPrestigiousPropertyCode | No | The lodging prestigious property code. If not passed in, this value defaults to NonParticipant.Allowable Values
|
| SpecialProgramCode | body | LodgingSpecialProgramCode | No | The lodging special program code. If not passed in, this value defaults to Default.Allowable Values
|
| ChargeType | body | LodgingChargeType | No | The lodging charge type. If not passed in, this value defaults to Default.Allowable Values
|
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| AccountNumber | body | string | No | The card account number. |
| BinValue | body | string | No | The BIN entry that matched the account number. |
| CardHolderName | body | string | No | The card holder name. |
| CardLogo | body | string | No | The card logo. Possible values are: Visa, Mastercard, Discover, Amex, Diners Club, JCB, Carte Blanche, Other. |
| CurrencyCode | body | CurrencyCode | No | The currency code used in the transaction.Allowable Values
|
| EntryMode | body | string | No | Description of how card was entered.Allowable Values |
| ExpirationYear | body | string | No | The card's expiration year |
| ExpirationMonth | body | string | No | The card's expiration month |
| PaymentType | body | PaymentType | No | Description of payment type utilized.Allowable Values
|
| PinVerified | body | bool | No | True if the PIN was verified, false if not verified or undetermined. |
| Signature | body | Signature | No | The signature data. |
| TerminalId | body | string | No | The ID of the terminal used during the transaction |
| TotalAmount | body | decimal | No | The total amount of 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
The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.
POST /json/reply/ForceCreditRequest HTTP/1.1
Host: booking.pufferdayspa.com
Content-Type: application/json
Content-Length: length
{"approvalNumber":"String","configuration":{"allowPartialApprovals":false,"checkForDuplicateTransactions":false,"currencyCode":"None","marketCode":"Default"},"transactionAmount":0,"lodging":{"customerName":"String","agreementNumber":"String","checkInDate":"String","checkOutDate":"String","roomAmount":0,"noShow":false,"duration":0,"extraChargesDetail":["NotUsed"],"prestigiousPropertyCode":"NonParticipant","specialProgramCode":"Default","chargeType":"Default"},"cardHolderPresentCode":"Default","clerkNumber":"String","laneId":0,"referenceNumber":"String","shiftId":"String","ticketNumber":"String"}
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: length
{"accountNumber":"String","binValue":"String","cardHolderName":"String","cardLogo":"String","currencyCode":"None","entryMode":"String","expirationYear":"String","expirationMonth":"String","paymentType":"None","pinVerified":false,"signature":{"data":"AA==","format":"String","statusCode":"Unknown"},"terminalId":"String","totalAmount":0,"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":[],"_logs":["String"],"_type":"String","_warnings":[{"developerMessage":"String","userMessage":"String"}]}