The Pyxis system has partnered with Datacap to provide card present functions for most of the transaction APIs. Card present means interaction with a Point Of Sale (POS) device by the customer using their credit/debit card to identify the account for the transaction. Pyxis will communicate with the terminal over the internet; the terminal connects to the internet through WiFi or network where it is installed. Please contact Constellation Payments for a list of POS devices that are compatible.
Sales can be initiated, voided, refunded using the POS terminal. You can do account verification and signature capture as well. Card present operations have been built into the same APIs as “card not present” operations. By changing the terminal ID you pass in to the API, you can direct the Pyxis API to interact with any physical POS terminal you have defined within the system.
Some elements in the request and response payloads for the Pyxis APIs will be available only with card present activity as well as others that will not be utilized will act differently. The biggest example is that you will not be providing account or account holder information to the transaction APIs since this data will be obtained when a customer swipes, taps, inserts, etc. on the device to provide what is needed. There may be other differences in calling the APIs in a card present situation. These differences will be noted in this document in the API descriptions.
IMPORTANT: Due to requirements of the card processors, the ability to handle partial payments has been turned on when using our card present functionality. This means that the amount returned in the API response for sale, authorize, etc. may be a lesser amount than you sent in the request. You should check to make sure that the amount in the response is equal to the amount in the request. What you do if the two amounts to not match is up to you. You can void the transaction, make another transaction for the remaining amount with another account or some other action.