REST API

Requirements  *** Merchant profile that contains credentials to login to the merchant portal - Backoffice Merchant must login to Backoffice and request a certificate, [1] only the certificate ID is required. The Gateway endpoints [2] are the same for Live & Test For integration purposes, a test applicationID must be used, while the LIVE application iD must be use real payments Optional Headers:* Authentication [3] of the user using AuthenticationToken & AuthenticationKey can be set in the headers Authentication * ** When interfacing with the iVeri Gateway, there are 2 forms of authentication that are supported. Digest Authentication (Optional): *Adding AuthenticationKey and AuthenticationToken in the headers and adding the certificateID in the body of the transaction or enquiry request  i

Avis Terminal and Device configuration process

Introduction *** Welcome to the PosPort Training Session, this session is aimed to provide details on the processes and procedures that need to be followed when onboarding and configuring a PosPort merchant. This process is important to ensure a merchant is accurately set up, so as the merchant can seamlessly process transaction as expected without any errors. Assumptions *** Actions assumed to be in place The Objectives of this learner guide are attainable on the assumption that the merchant profile already exist/captured on the Gateway Admin website by the acquiring bank. The Device/Terminal also needs to already be created and should exist on the gateway on request by the acquirer to None [1] assist@iveri.com . NEWPOS Devices have already been injected or loaded with the necessary key

Parameter Action

This section describes the various gateway parameters available. For more on input and output parameters per transaction type refer to Parameter Description & Action [1] Data Types  * ** The following key table is used for data types: Data Type * Description * A Alpha only (A-Za-z) AN Alphanumeric (a-zA-Z0-9) Base64 Base64 encryption of binary data Boolean True or False Guid Globally Unique Identifier:  {[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}\} (eg {8E51611F-E19A-4FF0-B229-6A69F42AAA62}) Hex Hex (0-9A-Fa-f) N Numeric (Positive integer) N. Digits and dots (.) (e.g's 4242........4242, 1.0) N: Digits and colons String ANPS Free format string containing: Alpha, numeric, special and padding (printable ASCII) Z Positive or negative integer Node Type * Set

SOAP API

Web Service implementation *** All methods provided by the web service return a V_XML formatted response. The GetPinBlock method is the only exception. For card present transactions, the GetPinBlock method will return a PINBlock data structure. The V_XML request and response format is defined by the V_XML.xsd schema, which can be downloaded from https://portal.nedsecure.co.za/schemas/v_xml/7.0/v_xml.xsd [1] Client code must check the respective Result fields to determine if the web service method was successful or not.  For a client to call the execute method the client certificate ID must be provided with the HTTP Request Webservice Gateway Address** SOAP Webservic EndPoints Purpose Usage Live and Test:  */iVeriWebservice/Service.asmx HTTP Method:* POST Submit transactions to iVeri Gatew

Cardinal & Indigo Release Notes V 20240709

The release notes contained in this document are available in iVeri’ s repository in production and can be installed on any Cardinal and or indigo installation on a case-by-case bases as agreed with Customers and or Integrators. Available to All Cardinal Customers * What’s New* Support of newly introduced DIGEST based authentication to cardinal level to be able to download recon/transactions/EMV parameters/hot cards, etc. from gateway. Introduction of a function to extract detailed reports on User Roles and Access Rights from the related Cardinal, enhancing access management. This report can be scheduled upon request, per cardinal. PosPort/* The user’s last login is now added to the "Users" View Module in BackOffice. An API is now available for management of NewPOS devices on merchant

Getting Started

Integrate with the iVeri Gateway using our *Enterprise solution*, and start accepting payments across multiple channels through a *single API*—available in both * REST [1] * and * SOAP [2] * formats. Payments Options available: *Online Payments*: Accept card payments on your website or mobile app by integrating a customized payment page tailored to your brand. *Payment Links*: Generate secure payment links via the iVeri Gateway and share them through your website, WhatsApp, or SMS—making it simple for customers to pay anytime, anywhere. *Recurring Payments*: Automate regular billing by leveraging our API for batch processing or submitting individual transactions—ideal for subscriptions and repeat services. *Transaction Reporting*: Streamline your reconciliation process by integrating our S

DiVert

Transactions ** Create Transaction Request * Purpose  /* - This function allows you to create a request for payment to be sent to cardholder Action: */ To create a transaction request, start by navigating to the DiVert tab on the homepage. Then, select Transactions and click on Create Transaction Request. image%20%282%29 [2] Action:* Here, choose the Live application ID. Once selected, you’ll be redirected to the Create Transaction Request form, where you can enter all the transaction details. image%20%283%29 [3] Create%20a%20Transaction%20Request%20-%203 [4] Let’s go through the details you’ll need to enter when creating a transaction request: Cardholder Name*: Enter the cardholder’s name exactly as it appears on the card. Cardholder Email*: Input the cardholder’s email address. This is

Gateway Response Codes

Transaction Result Codes ** Result Status* Result Code* Result Description* Additional Information * 0 (OK) 0 Approved/Successful -1 (Not OK) 1 Timeout waiting for response Either stop the transaction or wait a while before re-submitting.  Do not re-submit forever, have a limit in place of how many times a transaction can be re-submitted. -1 (Not OK) 2 Gateway unreachable Either stop the transaction or wait a while before re-submitting.  Do not re-submit forever, have a limit in place of how many times a transaction can be re-submitted. -1 (Not OK) 3 Hot card -1 (Not OK) 4 Denied -1 (Not OK) 5 Please call Merchant can phone their acquiring bank to obtain a telephonic authorisation.  If this is not possible then the transaction should be Denied. -1 (Not OK) 7 Invalid Authentication Data Car

How to resolve the WNET Run Fail Error on the 7210 Devices

Prognosis ** Merchants using NewPOS 7210 devices are experiencing an  inability to trade* due to the  “Wnet Run Fail”* error. This error is caused by the expiry of the  WNET file*, which manages SIM-based wireless connectivity on the device. Impact ** Devices relying on SIM connectivity are unable to establish a network connection, preventing merchants from processing transactions and trading. Action Required ** To restore connectivity and resume trading, the following actions are a necessity: Pre-Step* -  Ensure device serial numbers impacted are loaded onto the terminal management software (TMS). This step is to ensure the newPOS application update is made available for download to the devices.  This should be actioned by iVeri/TouchPoint, acquirers can provide a list of serial numbers a

Tokenisation: Transactionindex On Subsequent Transactions

This section explains how to implement a follow up/subsequent transaction using the TransactionIndex returned from an initial/previous transaction processed successfully. Merchants that wish to accept payments from regular customers without worrying about PCI DSS burdens of storing or retaining the card number have an option of submitting a unique identifier associated with the customers card number from a previously successfully processed transaction. In iVeri's realm, the identifier which the merchant can pass on subsequent transactions is called the “TransactionIndex”. This variable is an iVeri Gateway generated identifier commonly found in Gateway responses to the merchant. Initial Transaction ** When a merchant sends a transaction request(POST) to the iVeri Gateway, the response retur