Services Web Service

Services

Click here for a complete list of operations.

nombaPaymentUpdate

Test

The test form is only available for requests from the local machine.

SOAP 1.1

The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.

POST /Services.asmx HTTP/1.1
Host: services.tranzgate.com.ng
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "https://services.tranzgate.com.ng/nombaPaymentUpdate"

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <nombaPaymentUpdate xmlns="https://services.tranzgate.com.ng/">
      <request>
        <event_type>string</event_type>
        <requestId>string</requestId>
        <data>
          <merchant>
            <walletId>string</walletId>
            <walletBalance>decimal</walletBalance>
            <userId>string</userId>
          </merchant>
          <terminal>
            <terminalId>string</terminalId>
            <terminalLabel>string</terminalLabel>
          </terminal>
          <transaction>
            <fee>decimal</fee>
            <type>string</type>
            <transactionId>string</transactionId>
            <responseCode>string</responseCode>
            <originatingFrom>string</originatingFrom>
            <merchantTxRef>string</merchantTxRef>
            <transactionAmount>decimal</transactionAmount>
            <time>dateTime</time>
          </transaction>
          <customer>
            <billerId>string</billerId>
            <productId>string</productId>
          </customer>
          <order>
            <amount>decimal</amount>
            <orderId>string</orderId>
            <cardType>string</cardType>
            <accountId>string</accountId>
            <cardLast4Digits>string</cardLast4Digits>
            <cardCurrency>string</cardCurrency>
            <customerEmail>string</customerEmail>
            <customerId>string</customerId>
            <isTokenizedCardPayment>string</isTokenizedCardPayment>
            <orderReference>string</orderReference>
            <paymentMethod>string</paymentMethod>
            <callbackUrl>string</callbackUrl>
            <currency>string</currency>
          </order>
        </data>
      </request>
    </nombaPaymentUpdate>
  </soap:Body>
</soap:Envelope>

HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <nombaPaymentUpdateResponse xmlns="https://services.tranzgate.com.ng/" />
  </soap:Body>
</soap:Envelope>

SOAP 1.2

The following is a sample SOAP 1.2 request and response. The placeholders shown need to be replaced with actual values.

POST /Services.asmx HTTP/1.1
Host: services.tranzgate.com.ng
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?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>
    <nombaPaymentUpdate xmlns="https://services.tranzgate.com.ng/">
      <request>
        <event_type>string</event_type>
        <requestId>string</requestId>
        <data>
          <merchant>
            <walletId>string</walletId>
            <walletBalance>decimal</walletBalance>
            <userId>string</userId>
          </merchant>
          <terminal>
            <terminalId>string</terminalId>
            <terminalLabel>string</terminalLabel>
          </terminal>
          <transaction>
            <fee>decimal</fee>
            <type>string</type>
            <transactionId>string</transactionId>
            <responseCode>string</responseCode>
            <originatingFrom>string</originatingFrom>
            <merchantTxRef>string</merchantTxRef>
            <transactionAmount>decimal</transactionAmount>
            <time>dateTime</time>
          </transaction>
          <customer>
            <billerId>string</billerId>
            <productId>string</productId>
          </customer>
          <order>
            <amount>decimal</amount>
            <orderId>string</orderId>
            <cardType>string</cardType>
            <accountId>string</accountId>
            <cardLast4Digits>string</cardLast4Digits>
            <cardCurrency>string</cardCurrency>
            <customerEmail>string</customerEmail>
            <customerId>string</customerId>
            <isTokenizedCardPayment>string</isTokenizedCardPayment>
            <orderReference>string</orderReference>
            <paymentMethod>string</paymentMethod>
            <callbackUrl>string</callbackUrl>
            <currency>string</currency>
          </order>
        </data>
      </request>
    </nombaPaymentUpdate>
  </soap12:Body>
</soap12:Envelope>

HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?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>
    <nombaPaymentUpdateResponse xmlns="https://services.tranzgate.com.ng/" />
  </soap12:Body>
</soap12:Envelope>