Services Web Service

Services

Click here for a complete list of operations.

GetNombaTransactionByReference

Test

To test the operation using the HTTP POST protocol, click the 'Invoke' button.

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/GetNombaTransactionByReference"

<?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>
    <GetNombaTransactionByReference xmlns="https://services.tranzgate.com.ng/">
      <orderReference>string</orderReference>
      <test>boolean</test>
    </GetNombaTransactionByReference>
  </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>
    <GetNombaTransactionByReferenceResponse xmlns="https://services.tranzgate.com.ng/">
      <GetNombaTransactionByReferenceResult>
        <success>boolean</success>
        <message>string</message>
        <order>
          <orderId>string</orderId>
          <orderReference>string</orderReference>
          <customerId>string</customerId>
          <accountId>string</accountId>
          <callbackUrl>string</callbackUrl>
          <customerEmail>string</customerEmail>
          <amount>string</amount>
          <currency>string</currency>
        </order>
        <transactionDetails>
          <transactionDate>string</transactionDate>
          <paymentReference>string</paymentReference>
          <paymentVendorReference>string</paymentVendorReference>
          <tokenizedCardPayment>boolean</tokenizedCardPayment>
          <statusCode>string</statusCode>
        </transactionDetails>
        <transferDetails>
          <SessionId>string</SessionId>
          <BeneficiaryAccountName>string</BeneficiaryAccountName>
          <BeneficiaryAccountNumber>string</BeneficiaryAccountNumber>
          <OriginatorAccountName>string</OriginatorAccountName>
          <OriginatorAccountNumber>string</OriginatorAccountNumber>
          <Narration>string</Narration>
          <DestinationInstitutionCode>string</DestinationInstitutionCode>
          <PaymentReference>string</PaymentReference>
        </transferDetails>
        <cardDetails>
          <cardPan>string</cardPan>
          <cardType>string</cardType>
          <cardCurrency>string</cardCurrency>
          <cardBank>string</cardBank>
        </cardDetails>
      </GetNombaTransactionByReferenceResult>
    </GetNombaTransactionByReferenceResponse>
  </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>
    <GetNombaTransactionByReference xmlns="https://services.tranzgate.com.ng/">
      <orderReference>string</orderReference>
      <test>boolean</test>
    </GetNombaTransactionByReference>
  </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>
    <GetNombaTransactionByReferenceResponse xmlns="https://services.tranzgate.com.ng/">
      <GetNombaTransactionByReferenceResult>
        <success>boolean</success>
        <message>string</message>
        <order>
          <orderId>string</orderId>
          <orderReference>string</orderReference>
          <customerId>string</customerId>
          <accountId>string</accountId>
          <callbackUrl>string</callbackUrl>
          <customerEmail>string</customerEmail>
          <amount>string</amount>
          <currency>string</currency>
        </order>
        <transactionDetails>
          <transactionDate>string</transactionDate>
          <paymentReference>string</paymentReference>
          <paymentVendorReference>string</paymentVendorReference>
          <tokenizedCardPayment>boolean</tokenizedCardPayment>
          <statusCode>string</statusCode>
        </transactionDetails>
        <transferDetails>
          <SessionId>string</SessionId>
          <BeneficiaryAccountName>string</BeneficiaryAccountName>
          <BeneficiaryAccountNumber>string</BeneficiaryAccountNumber>
          <OriginatorAccountName>string</OriginatorAccountName>
          <OriginatorAccountNumber>string</OriginatorAccountNumber>
          <Narration>string</Narration>
          <DestinationInstitutionCode>string</DestinationInstitutionCode>
          <PaymentReference>string</PaymentReference>
        </transferDetails>
        <cardDetails>
          <cardPan>string</cardPan>
          <cardType>string</cardType>
          <cardCurrency>string</cardCurrency>
          <cardBank>string</cardBank>
        </cardDetails>
      </GetNombaTransactionByReferenceResult>
    </GetNombaTransactionByReferenceResponse>
  </soap12:Body>
</soap12:Envelope>

HTTP GET

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

GET /Services.asmx/GetNombaTransactionByReference?orderReference=string&test=string HTTP/1.1
Host: services.tranzgate.com.ng

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

<?xml version="1.0" encoding="utf-8"?>
<NombaTransactionResult xmlns="https://services.tranzgate.com.ng/">
  <success>boolean</success>
  <message>string</message>
  <order>
    <orderId>string</orderId>
    <orderReference>string</orderReference>
    <customerId>string</customerId>
    <accountId>string</accountId>
    <callbackUrl>string</callbackUrl>
    <customerEmail>string</customerEmail>
    <amount>string</amount>
    <currency>string</currency>
  </order>
  <transactionDetails>
    <transactionDate>string</transactionDate>
    <paymentReference>string</paymentReference>
    <paymentVendorReference>string</paymentVendorReference>
    <tokenizedCardPayment>boolean</tokenizedCardPayment>
    <statusCode>string</statusCode>
  </transactionDetails>
  <transferDetails>
    <SessionId>string</SessionId>
    <BeneficiaryAccountName>string</BeneficiaryAccountName>
    <BeneficiaryAccountNumber>string</BeneficiaryAccountNumber>
    <OriginatorAccountName>string</OriginatorAccountName>
    <OriginatorAccountNumber>string</OriginatorAccountNumber>
    <Narration>string</Narration>
    <DestinationInstitutionCode>string</DestinationInstitutionCode>
    <PaymentReference>string</PaymentReference>
  </transferDetails>
  <cardDetails>
    <cardPan>string</cardPan>
    <cardType>string</cardType>
    <cardCurrency>string</cardCurrency>
    <cardBank>string</cardBank>
  </cardDetails>
</NombaTransactionResult>

HTTP POST

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

POST /Services.asmx/GetNombaTransactionByReference HTTP/1.1
Host: services.tranzgate.com.ng
Content-Type: application/x-www-form-urlencoded
Content-Length: length

orderReference=string&test=string

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

<?xml version="1.0" encoding="utf-8"?>
<NombaTransactionResult xmlns="https://services.tranzgate.com.ng/">
  <success>boolean</success>
  <message>string</message>
  <order>
    <orderId>string</orderId>
    <orderReference>string</orderReference>
    <customerId>string</customerId>
    <accountId>string</accountId>
    <callbackUrl>string</callbackUrl>
    <customerEmail>string</customerEmail>
    <amount>string</amount>
    <currency>string</currency>
  </order>
  <transactionDetails>
    <transactionDate>string</transactionDate>
    <paymentReference>string</paymentReference>
    <paymentVendorReference>string</paymentVendorReference>
    <tokenizedCardPayment>boolean</tokenizedCardPayment>
    <statusCode>string</statusCode>
  </transactionDetails>
  <transferDetails>
    <SessionId>string</SessionId>
    <BeneficiaryAccountName>string</BeneficiaryAccountName>
    <BeneficiaryAccountNumber>string</BeneficiaryAccountNumber>
    <OriginatorAccountName>string</OriginatorAccountName>
    <OriginatorAccountNumber>string</OriginatorAccountNumber>
    <Narration>string</Narration>
    <DestinationInstitutionCode>string</DestinationInstitutionCode>
    <PaymentReference>string</PaymentReference>
  </transferDetails>
  <cardDetails>
    <cardPan>string</cardPan>
    <cardType>string</cardType>
    <cardCurrency>string</cardCurrency>
    <cardBank>string</cardBank>
  </cardDetails>
</NombaTransactionResult>

Parameter	Value
orderReference:
test: