Version History

DateDetailsEnd Points
30/09/22 Initial releaseiPOS Transact V1 and above
30/05/24 Version 2 - AVS ObjiPOS Transact V2 and above
20/08/24 Ticket, Tip Adjust - transaction typeiPOS Transact V2 and above
28/01/25 Google payiPOS Transact V2 and above
29/04/25 Paya TokeniPOS Transact V2 and above
08/05/25 ACH TokeniPOS Transact V2 and above
13/05/25 HSA card FeaturesiPOS Transact V2 and above
21/05/25 Version 3 - Encrypted Card DataiPOS 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 transactioniPOS Transact V1 and above
19/10/25 Added Level 3 / VISA CEDP support for transactionsiPOS 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 2tipwasaddedusingTipAdjust,submittingaZeroDollarTipAdjustwillremovethe2 tip was added using Tip Adjust, submitting a Zero Dollar Tip Adjust will remove the 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

On this page