PANToken Enquiry and Followup Transactions

Technical questions relating to the iVeri WebService integration
Post Reply
samora
Posts: 54
Joined: Thu Sep 17, 2015 3:29 pm

Wed Oct 07, 2015 10:14 am

In this example, i will assume that you are making use of the service https://portal.nedsecure.co.za/iVeriWeb ... .asmx?wsdl and also assume that you have had a look at the following sections of the iVeri Client Developers Guide
  • 15.1 Web Service implementation
    7.4 Parameter description
Obtain a TransactionIndex for the card number and expiry date without performing a transaction. The TransactionIndex is to be used in a Tokenized transaction.

For Pan token the command should be "PANToken", this will return the transactionindex and masked pan. Also note that this is not an actual transaction to the bank hence we classify it as an Enquiry.
Request:
<V_XML Version="2.0" CertificateID="{00000000-0000-0000-0000-000000000000}" Direction="Request">
<Enquiry ApplicationID="{00000000-0000-0000-0000-000000000000}" Command="PANToken" Mode="Live">
<ExpiryDate>102017</ExpiryDate>
<PAN>4242424242424242</PAN>
</Enquiry>
</V_XML>

Response
<V_XML Version="2.0" Direction="Response">
<Enquiry ApplicationID="{FDC8479B-91F4-4CCD-8A00-7DA10E76E71E}" Command="PANToken" Mode="Live" RequestID="{5E74A412-7AE0-4CB7-93AA-49F4F1B65505}">
<Result Status="0" AppServer="105IVERIAPPPR02" DBServer="105iveridbpr01" Gateway="Nedbank">
<TransactionIndex>{11111111-0000-0000-1111-000000000000}</TransactionIndex>
<PAN>4242.......2424</PAN>
</Enquiry>
</V_XML>
The following field values need to be stored on your database.
  • <TransactionIndex>
    <PAN>
    <ExpiryDate>
Now when the card holder is ready to do an actual transaction you will need to pass the following.
In the below, we have assumed that you have prompted for the cvv of the card hence the value for "CardSecurityCode".

Request:
<V_XML Version="2.0" CertificateID="{00000000-0000-0000-0000-000000000000}" Direction="Request">
<Transaction ApplicationID="{00000000-0000-0000-0000-000000000000}" Command="Debit" Mode="Live">
<PANFormat>TransactionIndex</PANFormat>
<Amount>3000</Amount>
<Currency>ZAR</Currency>
<ExpiryDate>102017</ExpiryDate>
<MerchantReference>348004819</MerchantReference>
<CardSecurityCode>231</CardSecurityCode>
<TransactionIndex>{11111111-0000-0000-1111-000000000000}</TransactionIndex>
<PAN>4242........4242</PAN>
</Transaction>
</V_XML>

Response
<V_XML Version="2.0" Direction="Response">
<Transaction ApplicationID="{00000000-0000-0000-0000-000000000000}" Command="Debit" Mode="Live" RequestID="{BC0D7978-A6E7-4857-8367-EDBBFDD3F20D}">
<Result Status="0" AppServer="105IVERIAPPPR01" DBServer="105iveridbpr01" Gateway="Nedbank" />
<Amount>3000</Amount>
<AuthorisationCode>703258</AuthorisationCode>
<Currency>ZAR</Currency>
<ExpiryDate>102017</ExpiryDate>
<MerchantReference>348004819</MerchantReference>
<Terminal>Default</Terminal>
<TransactionIndex>{5C73DB3B-8DCC-4CC6-BDD0-7B7A1B236BF1}</TransactionIndex>
<MerchantName>My Merchant</MerchantName>
<MerchantUSN>200000000</MerchantUSN>
<Acquirer>NedbankPostilion</Acquirer>
<AcquirerReference>51007:00000000</AcquirerReference>
<AcquirerDate>20151007</AcquirerDate>
<AcquirerTime>095558</AcquirerTime>
<DisplayAmount>R 30.00</DisplayAmount>
<BIN>424242</BIN>
<Association>VISA</Association>
<CardType>Unknown CardType</CardType>
<Issuer>Unknown</Issuer>
<Jurisdiction>Local</Jurisdiction>
<PANMode>Keyed,CVV</PANMode>
<ReconReference>00000000</ReconReference>
<CardHolderPresence>CardNotPresent</CardHolderPresence>
<MerchantAddress>MERCHANT ADDRESS</MerchantAddress>
<MerchantCity>Cape Town</MerchantCity>
<MerchantCountryCode>ZA</MerchantCountryCode>
<MerchantCountry>South Africa</MerchantCountry>
<DistributorName>Nedbank</DistributorName>
<CCNumber>4242........4242</CCNumber>
<PAN>4242........4242</PAN>
</Transaction>
</V_XML>


Note that you will have to make use of <TransactionIndex>{5C73DB3B-8DCC-4CC6-BDD0-7B7A1B236BF1}</TransactionIndex> for the next transaction and daisy chain then everytime you get a response from us.
Last edited by samora on Mon Nov 16, 2015 2:26 pm, edited 1 time in total.
samora
Posts: 54
Joined: Thu Sep 17, 2015 3:29 pm

Wed Oct 07, 2015 10:19 am

Soap Request:

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
<soap12:Body>
<Execute xmlns="http://iveri.com/">
<validateRequest>false</validateRequest>
<protocol>V_XML</protocol>
<protocolVersion>4.0</protocolVersion>
<request>string</request>
</Execute>
</soap12:Body>
</soap12:Envelope>

Above request value would be the actual V_XML request as shown in the original post and the xsd is https://portal.nedsecure.co.za/schemas/ ... /v_xml.xsd
Post Reply