MarketPlaces

A marketplace is a third-party platform that facilitates payment acceptance between buyers and retailers through a unified digital interface, typically offered via an e-commerce website and mobile application. Transactions processed by marketplaces are classified as “card-not-present”, reflecting the remote nature of the payment interaction.

In this model, the marketplace acts on behalf of the retailer to process payments and settle funds into the retailer’s bank account. It contracts directly with the acquiring bank for payment acceptance and is recognized as the merchant of record, rather than the individual retailers. Additionally, the marketplace manages the end-to-end customer experience, including accepting payments and issuing transaction confirmations on behalf of the retailers.

Requirements:

The marketplace must register a merchant account with an acquiring bank.

The acquiring bank must register the marketplace with the card networks.

When processing transactions through the iVeri Gateway, the marketplace must identify each retailer as either “Local” or “Foreign” on a per-transaction basis.

REST Message

Format: JSON

Request
{
"Version": "2.0",
"CertificateID": "{808e0357-23d7-41e3-9af3-8c799d580960}",
"ProductType": "Enterprise",
"ProductVersion": "WebAPI",
"Direction": "Request",
"Transaction": {
"ApplicationID": "{e6adc303-cd90-4d37-b84e-5b280bcb20e2}",
"Command": "Debit",
"Mode": "Test",
"MerchantReference": "F89m_09098",
"MerchantTrace":"20240826_540",
"Currency": "ZAR",
"Amount": "1000",
"ExpiryDate": "1227",
"PAN": "4242424242424242",
"ForeignRetailIndicator":" Foreign"

}
}

Response
{
"Version": "2.0",
"Direction": "Response",
"Transaction": {
"MerchantTrace": "20240826_540",
"Amount": "1000",
"AuthorisationCode": "397585",
"CCNumber": "4242........4242",
"Currency": "ZAR",
"ExpiryDate": "122027",
"MerchantReference": "F89m_09098",
"Terminal": "Default",
"TransactionIndex": "{9833A3AA-22F4-419B-B754-C965487B9849}",
"OriginalRequestID": "{FD7D61F4-26DE-4DC2-ADAE-7E0CD1008A34}",
"MerchantName": "iVeri Payment Technology",
"MerchantUSN": "7771777",
"Acquirer": "NBPostilionNBSouthAfrica",
"AcquirerReference": "96651:05358081",
"AcquirerDate": "20250804",
"AcquirerTime": "142625",
"DisplayAmount": "R 10.00",
"BIN": "42424242",
"Association": "VISA",
"CardType": "Unknown CardType",
"Issuer": "Unknown Issuer",
"Jurisdiction": "International",
"PAN": "4242........4242",
"PANMode": "Keyed",
"ReconReference": "05358081",
"CardHolderPresence": "CardNotPresent",
"MerchantAddress": "171 Katherine Street\nSandton",
"MerchantCity": "Sandton",
"MerchantCountryCode": "ZA",
"MerchantCountry": "South Africa",
"DistributorName": "Nedbank",
"ApplicationID": "{E6ADC303-CD90-4D37-B84E-5B280BCB20E2}",
"Command": "Debit",
"Mode": "Test",
"RequestID": "{1D5F637B-F5A5-4629-A281-CD48FD62E0F7}",
"Result": {
"Status": "0",
"Code": "0",
"Description": "",
"Previous": "true",
"AppServer": "105IVERIAPPPR2N",
"DBServer": "105iveridbpr01n",
"Gateway": "Nedbank"
}
}
}