Version History
| Date | Details | End Points |
|---|---|---|
| 30/09/22 | Initial release | iPOS Transact V1 and above |
| 30/05/24 | Version 2 - AVS Obj | iPOS Transact V2 and above |
| 20/08/24 | Ticket, Tip Adjust - transaction type | iPOS Transact V2 and above |
| 28/01/25 | Google pay | iPOS Transact V2 and above |
| 29/04/25 | Paya Token | iPOS Transact V2 and above |
| 08/05/25 | ACH Token | iPOS Transact V2 and above |
| 13/05/25 | HSA card Features | iPOS Transact V2 and above |
| 21/05/25 | Version 3 - Encrypted Card Data | iPOS Transact V3 |
| 05/08/25 | Introduced support for Encrypted Card Data and added Authentication Token API, enabling users to securely generate tokens via API instead of the portal. | Use the V3 endpoint to send encrypted card data, perform transactions such as Sale, Refund, Void, and more, and generate/manage authentication tokens via the Authentication Token API instead of manual portal-based token generation. |
| 25/09/25 | Added Gift transaction | iPOS Transact V1 and above |
| 19/10/25 | Added Level 3 / VISA CEDP support for transactions | iPOS Transact V1 |
| 08/07/2026 | Updated void and refund transactions to allow the Amount field to be left empty. Transactions are rejected if the Amount field is explicitly set to 0. | iPOS Transact V1 and above |
Note: Please use the V3 endpoint to send encrypted card data and to perform actions such as sale, refund, void, and other transactions.
Prerequisites
- For Sandbox (UAT)
Users should be Onboarded on iPOSpays sandbox(UAT) environment as a merchant and have a valid TPN.
- For Production (Live)
Users should be onboarded on iPOSpays production environment as a merchant and have a valid TPN.
If you do not have a TPN, contact your ISO or devsupport@dejavoo.io
Supported Transaction Types
The iPOS Transact API allows you to perform the following transactions:
-
Sale - A sale transaction is a regular transaction where the entered amount is processed and sent to the processor after the batch has been settled.
-
Pre Auth - A Pre Auth transaction allows the user to temporarily reserve a specific amount of money for a transaction.
-
Zero Dollar Pre Auth: If you want to obtain a card token without processing a transaction, submit a Zero Dollar Pre-Authorization request. Use the same request parameters as a standard Pre-Authorization transaction, but set the transaction amount to 0.00. This allows the card to be validated and tokenized without charging the customer.
-
Void - A Void transaction is used to cancel a previously authorized transaction before the batch is closed and sent to the processor.
-
Refund - A Refund transaction is used to refund the amount back to the customer after the batch has been settled. The refund amount is then sent to the processor.
-
Ticket - A Ticket transaction is used to retrieve and process the amount that was temporarily held in the Pre Auth transaction.
-
Tip Adjust - Tip Adjust enables users to modify the tip amount on a transaction before the batch is settled and sent to the processor.
-
Zero Dollar Tip Adjust: Use a Zero Dollar Tip Adjust to remove a previously adjusted tip amount. For example, if a 2 tip and restore the transaction to its original amount.
-
Incremental Auth - Incremental Authorization allows merchants to easily adjust a Pre Auth transaction when a customer exceeds the initial amount, without having to void and reprocess the transaction.
-
Open Batch - An Open Batch allows merchants to view all transactions, review the batch summary, and void transactions before they are settled and sent to the processor.
-
Batch Settlement - Batch settlement is the process of consolidating and submitting all authorized transactions at the end of the business day to the payment processor. This ensures timely reconciliation and transfer of funds to the merchant’s bank account.
-
Gift - A Gift Transaction refers to a transaction where a customer uses a gift card balance as a payment method to complete a purchase.
-
Level 3 / VISA CEDP (Sale): - A Level 3 / VISA CEDP sale transaction enables you to include detailed line-item information in the sale requests. By providing this enhanced transaction data, you can qualify for better interchange rates offered by the card networks.
Supported Fee Types
The iPOS Transact API supports the following fee types:
-
Custom Fee
-
Surcharge
-
Tender-Based Pricing
-
Dual Pricing
-
True Cash Discount
Supported Payment Processors
Card Payments
- TSYS
- Fiserv North
- Fiserv Omaha
- WorldPay
- EPX
- Elavon
Bank (ACH) Payments
- Paya
- Vericheck
Error Codes and Their Meaning
For a complete list of error codes and their explanations, please visit our Error Codes Reference Page.
Last updated on September 8, 2026