MobileRecharge

Click here for a complete list of operations.

PerformPinlessRecharge

Test

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

Parameter	Value
username:
password:
recipientMsisdn:
voucherId:
amount:
clientRef:

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 /MobileRecharge.asmx HTTP/1.1
Host: mobilerechargeapi.gsm.co.za
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "https://mobilerechargeapi.gsm.co.za/PerformPinlessRecharge"

<?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>
    <PerformPinlessRecharge xmlns="https://mobilerechargeapi.gsm.co.za/">
      <username>string</username>
      <password>string</password>
      <recipientMsisdn>string</recipientMsisdn>
      <voucherId>int</voucherId>
      <amount>decimal</amount>
      <clientRef>string</clientRef>
    </PerformPinlessRecharge>
  </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>
    <PerformPinlessRechargeResponse xmlns="https://mobilerechargeapi.gsm.co.za/">
      <PerformPinlessRechargeResult>
        <VoucherPin>string</VoucherPin>
        <OrderRef>string</OrderRef>
        <TicketNumber>string</TicketNumber>
        <BoxNumber>string</BoxNumber>
        <BatchNumber>string</BatchNumber>
        <TransactionError>boolean</TransactionError>
        <Error>string</Error>
      </PerformPinlessRechargeResult>
    </PerformPinlessRechargeResponse>
  </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 /MobileRecharge.asmx HTTP/1.1
Host: mobilerechargeapi.gsm.co.za
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>
    <PerformPinlessRecharge xmlns="https://mobilerechargeapi.gsm.co.za/">
      <username>string</username>
      <password>string</password>
      <recipientMsisdn>string</recipientMsisdn>
      <voucherId>int</voucherId>
      <amount>decimal</amount>
      <clientRef>string</clientRef>
    </PerformPinlessRecharge>
  </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>
    <PerformPinlessRechargeResponse xmlns="https://mobilerechargeapi.gsm.co.za/">
      <PerformPinlessRechargeResult>
        <VoucherPin>string</VoucherPin>
        <OrderRef>string</OrderRef>
        <TicketNumber>string</TicketNumber>
        <BoxNumber>string</BoxNumber>
        <BatchNumber>string</BatchNumber>
        <TransactionError>boolean</TransactionError>
        <Error>string</Error>
      </PerformPinlessRechargeResult>
    </PerformPinlessRechargeResponse>
  </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 /MobileRecharge.asmx/PerformPinlessRecharge?username=string&password=string&recipientMsisdn=string&voucherId=string&amount=string&clientRef=string HTTP/1.1
Host: mobilerechargeapi.gsm.co.za

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

<?xml version="1.0" encoding="utf-8"?>
<RechargeInfo xmlns="https://mobilerechargeapi.gsm.co.za/">
  <VoucherPin>string</VoucherPin>
  <OrderRef>string</OrderRef>
  <TicketNumber>string</TicketNumber>
  <BoxNumber>string</BoxNumber>
  <BatchNumber>string</BatchNumber>
  <TransactionError>boolean</TransactionError>
  <Error>string</Error>
</RechargeInfo>

HTTP POST

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

POST /MobileRecharge.asmx/PerformPinlessRecharge HTTP/1.1
Host: mobilerechargeapi.gsm.co.za
Content-Type: application/x-www-form-urlencoded
Content-Length: length

username=string&password=string&recipientMsisdn=string&voucherId=string&amount=string&clientRef=string

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

<?xml version="1.0" encoding="utf-8"?>
<RechargeInfo xmlns="https://mobilerechargeapi.gsm.co.za/">
  <VoucherPin>string</VoucherPin>
  <OrderRef>string</OrderRef>
  <TicketNumber>string</TicketNumber>
  <BoxNumber>string</BoxNumber>
  <BatchNumber>string</BatchNumber>
  <TransactionError>boolean</TransactionError>
  <Error>string</Error>
</RechargeInfo>