Card Transaction Command

This is used to initiate a card transaction on the POS terminal. The amount of goods purchase is to be sent along in the request as shown below. The transaction would be completed on the POS as the customer would be prompted to key in his / her Paycode and transaction would be sent upstream for approval and a response is returned.

Sample request

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

Response Message field description

This field will vary depending on the transaction:

FieldField NameDescription
1StanTerminal serial counter
2AuthCodeTransaction Authorization Code
3RespMessageTransaction Response Message
4RespCodeTransaction Response Code
5AmountTransaction Amount
6TerminalIdPOS Terminal Id
7PaycodePaycode used for the transaction
8StaffStaff Id of the teller or cashier
9Payment OptionThe 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> 
<MaskPan>50610****3458/MaskPan> 
<staff>123S89</staff> 
<paymentOption>card</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> 
<MaskPan>50610****3458/MaskPan> 
<staff>123S89</staff> 
<paymentOption>card</paymentOption> 
</transResponse>