The examples apply when using the web service interface to perform various transactions. The examples serve to showcase a set of parameters that are largely used when performing transactions using the schema definition available in the SOAP interface which are also commonly used on the REST API. The functionality and related parameter definitions, elements supported are standard in the SOAP schema and REST API
Further insights on the transaction types and their meanings, refer to the “Commands” and
“Actions” sections and these have to be used in conjunction with the input parameters per actions. For the corresponding transaction flows per transactions type refer to transaction sequence
The examples cover the following messages:
The transaction Request and Response cover the following:
The
The Mauritius Central Automated Switch (MauCAS), a digital hub exclusively owned and managed by the Bank of Mauritius, facilitating seamless 24/7 payment routing among various operators. CIM Finance is introducing QR-code-based payments through seamless integration with MauCAS, thereby diversifying the payment options for their valued merchants.
IYS Implementation Guide
**
This purpose of this sections is to give some domain knowledge to people not familiar with the payment domain.
JSON Response *** {
"GatewayInfo": [
{
"Status": "Up",
"StatusSince": "2019-02-12 03:22:45",
"GatewayDNS": "https://portal.iveri.net%22%2C/
"Name": "Gateway Provider",
"Latency": 124
},
{
"Status": "Up",
"StatusSince": "2019-02-12 03:22:47",
"GatewayDNS": "https://portal.iveri.net%22%2C/
"Name": "NBPostilion NBSouthAfrica Gateway Provider",
"Latency": 93
}
],
"DeviceInfo": [
{
"Status": "Disconnected",
"Transactions": 11,
"LastTransactionEnd": "2019-02-11 14:38:51",
"LastTransactionStart": "2019-02-11 14:38:30",
"Version": "IPP350 - RA12105",
"ConnectedSince": "2019-02-11 13:13:50",
"DeviceSerialNumber": "81528455",
"SocketAddress": "192.168.128.85:1030",
"Latency": 312
},
{
"Status": "Idle",
"Transactions": 0,
"LastTransactionEnd": "",
"LastTransactionStart": "",
"Version": "IPP350 - RA11
JSON Request *
**
{
"Command": "Credit",
"DeviceSerialNumber": "81546628",
"MerchantReference": "Roland20190212.1",
"Amount": 1001,
"OriginalMerchantTrace": "292732.287654448218"
}
JSON Response *
**
{
"MerchantReference": "Roland20190212.4",
"Amount": 1004,
"CardAcceptorID": "1732668",
"AuthorisationCode": "231056",
"Product": "Indigo",
"TransactionDateTime": "2019-02-12 08:40:23",
"DeviceSerialNumber": "81546628",
"MerchantTrace": "292742.287656823473",
"Result": {
"Description": "Approved",
"Code": "0"
},
"DisplayAmount": "R 10.04",
"OriginalMerchantTrace": "292741.287656655810",
"TransactionTypeDescription": "",
"MerchantName": "ArchRetail",
"Command": "AuthorisationReversal",
"Version": "0482.01",
"TransactionIndex": "{E275FF1B-610C-4D8F-ACFF-ED936DF82AC6}",
"AcquirerReference": "01431:09014053",
"PAN": "4923........1826",
"TransactionCertificate": "{8a80fe66-4032-4cd9-b9f6-763762417e46}"
}
REST Endpoints *
**
• Only one REST endpoint exists on the Indigo server and it will be at http://ipaddress/rest/transaction/transact or https://ipaddress/rest/transaction/transact where ipaddress is the local or external ip address or dns of the Indigo server as appropriate. Note that only TLS1.2 or above should be used.
• Only POST method is supported, and the data submitted must be in JSON format.
• The response from the Indigo server will also be in JSON format
• In the request header set request.Accept = "application/json";
• in the request header set request.ContentType = "application/json";
The design of this interface is to use synchronous REST calls to perform either an “Authorisation”, “Debit” or “Credit” which leads to a potential problem in the event that a card is not presente
* ** Dynamic Currency Conversion (DCC) *
DCC is service that enables payment card cardholders to make international card purchases or transactions in their own currency. The conversion of the purchase price of goods or services from the merchant’s local currency to the cardholder’s home currency occurs at the point of sale at the quoted exchange rate from a cited exchange rate source.
* DCC Transaction Flow *
Perform an enquiry DCC rate request using a PAN and Amount to the iVeri Gateway Merchant presents the returned DCC rate offer to the customer Perform a transaction using the customers elected currency