Services

Click here for a complete list of operations.

postPayment

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

<?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>
    <postPayment xmlns="https://services.tranzgate.com.ng/">
      <username>string</username>
      <password>string</password>
      <bankID>string</bankID>
      <clientNo>string</clientNo>
      <customerNo>string</customerNo>
      <paymentPostingInfo>
        <PaymentPostingInfo>
          <PaymentCode>string</PaymentCode>
          <PaymentText>string</PaymentText>
          <Currency>Naira or Dollars or Pounds or Euros</Currency>
          <Amount>decimal</Amount>
          <PaymentDocumentNo>string</PaymentDocumentNo>
          <Bank>string</Bank>
          <AccountNum>string</AccountNum>
        </PaymentPostingInfo>
        <PaymentPostingInfo>
          <PaymentCode>string</PaymentCode>
          <PaymentText>string</PaymentText>
          <Currency>Naira or Dollars or Pounds or Euros</Currency>
          <Amount>decimal</Amount>
          <PaymentDocumentNo>string</PaymentDocumentNo>
          <Bank>string</Bank>
          <AccountNum>string</AccountNum>
        </PaymentPostingInfo>
      </paymentPostingInfo>
      <channel>NotSet or Bank or Interswitch2023 or UnifiedPayments or RemitaBank or RemitaOnline or UnifiedPaymentsPOS or ALATPay or Zitra or ZitraTranzgate or Nomba</channel>
      <session>string</session>
      <preregisteredpaymentbatchid>string</preregisteredpaymentbatchid>
      <test>boolean</test>
    </postPayment>
  </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>
    <postPaymentResponse xmlns="https://services.tranzgate.com.ng/">
      <postPaymentResult>
        <PaymentBatchID>string</PaymentBatchID>
        <PaymentStatus>Rejected or Finalized or Pending or Warning or Error</PaymentStatus>
        <PaymentStatusString>string</PaymentStatusString>
      </postPaymentResult>
    </postPaymentResponse>
  </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>
    <postPayment xmlns="https://services.tranzgate.com.ng/">
      <username>string</username>
      <password>string</password>
      <bankID>string</bankID>
      <clientNo>string</clientNo>
      <customerNo>string</customerNo>
      <paymentPostingInfo>
        <PaymentPostingInfo>
          <PaymentCode>string</PaymentCode>
          <PaymentText>string</PaymentText>
          <Currency>Naira or Dollars or Pounds or Euros</Currency>
          <Amount>decimal</Amount>
          <PaymentDocumentNo>string</PaymentDocumentNo>
          <Bank>string</Bank>
          <AccountNum>string</AccountNum>
        </PaymentPostingInfo>
        <PaymentPostingInfo>
          <PaymentCode>string</PaymentCode>
          <PaymentText>string</PaymentText>
          <Currency>Naira or Dollars or Pounds or Euros</Currency>
          <Amount>decimal</Amount>
          <PaymentDocumentNo>string</PaymentDocumentNo>
          <Bank>string</Bank>
          <AccountNum>string</AccountNum>
        </PaymentPostingInfo>
      </paymentPostingInfo>
      <channel>NotSet or Bank or Interswitch2023 or UnifiedPayments or RemitaBank or RemitaOnline or UnifiedPaymentsPOS or ALATPay or Zitra or ZitraTranzgate or Nomba</channel>
      <session>string</session>
      <preregisteredpaymentbatchid>string</preregisteredpaymentbatchid>
      <test>boolean</test>
    </postPayment>
  </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>
    <postPaymentResponse xmlns="https://services.tranzgate.com.ng/">
      <postPaymentResult>
        <PaymentBatchID>string</PaymentBatchID>
        <PaymentStatus>Rejected or Finalized or Pending or Warning or Error</PaymentStatus>
        <PaymentStatusString>string</PaymentStatusString>
      </postPaymentResult>
    </postPaymentResponse>
  </soap12:Body>
</soap12:Envelope>