Transfer Transaction Command

The amount for the goods or services being purchased is to be sent along in the request, as shown below. A unique payment reference or transfer code will be generated, which the customer will use to complete the payment via their mobile banking app or USSD. The terminal will poll for confirmation of the payment, and once the transfer is successfully received, the transaction will be marked as completed and a response returned.

Sample Request

<request> 
<command>purchase</command> 
<amount>100</amount> 
<accounttype>default</accounttype> 
<paymentOption>transfer</paymentOption> 
<staff>123S89</staff> 
</request>

Response Message field description

This field will vary depending on the transaction:

Field	Field Name	Description
1	Stan	Terminal serial counter
2	AuthCode	Transaction Authorization Code
3	RespMessage	Transaction Response Message
4	RespCode	Transaction Response Code
5	Amount	Transaction Amount
6	TerminalId	POS Terminal Id
7	Paycode	Paycode used for the transaction
8	Staff	Staff Id of the teller or cashier
9	Payment Option	The method used for Payment

Sample Response (success)

The response for success: at least a port is returned

<transResponse> 
<Stan>000003</Stan> 
<AuthCode>123456</AuthCode> 
<RespMessage>Transaction Approved</RespMessage> 
<RespCode>00</RespCode> 
<Amount>100</Amount> 
<TerminalId>2056XYZ1</TerminalId>  
<staff>123S89</staff> 
<paymentOption>transfer</paymentOption> </transResponse>

Sample Response (failure)

<transResponse> 
<Stan>000003</Stan> 
<AuthCode>123456</AuthCode> 
<RespMessage>Insufficient Funds</RespMessage> 
<RespCode>51</RespCode> 
<Amount>100</Amount> 
<TerminalId>2056XYZ1</TerminalId> 
<staff>123S89</staff> 
<paymentOption>transfer</paymentOption> 
</transResponse>