Deduct

post https://example.com/deduct

Deducts an amount from a wallet.

This operation deducts the requested amount from a wallet using multiple authentication and context parameters.

REQUEST

PATH PARAMETERS

Parameter	Type & Attributes	Description
`terminalID`	string, required	Our partner issued terminal ID of the terminal requesting the transaction
`reference`	string, required	The reference of the wallet to deduct
`requestAmount`	integer, required	The amount to be deducted in cents
`narrative`	string, required	A description of the terminal where the card was used
`transactionType`	string, required	2 character string identifying the type of transaction: 00 = POS 01 = ATM 09 = Cashback at POS 10 = AFT 30 = Balance Inquiry "Used only for Acquirer fees applied on balance inquiry"
`transactionData`	string, required	Extra information about the transaction in a KLV Format
`transactionID`	string, required	Transaction ID number generated by the calling client. Note that the Transaction ID is not a unique value and may be duplicated over time
`transactionDate`	date, required	Transaction date (in UTC) generated by the calling client
`checksum`	string, required	HMAC-SHA256 hashed signature of the concatenated method name with all argument values using the terminal password as private key


  <?xml version="1.0"?>
  <methodCall>
    <methodName>Deduct</methodName>
    <params>
      <param><value><string>0068766621</string></value></param>
      <param><value><string>43172792905</string></value></param>
      <param><value><int>200</int></value></param>
      <param><value><string>KARINA FURNITURE CURACAO CUW</string></value></param>
      <param><value><string>00</string></value></param>
      <param><value><string>0021562702810000002100412000000000200026045712049038400850025003EMV25110MasterCard2530451122540025500</string></value></param>
      <param><value><string>401897</string></value></param>
      <param><value><dateTime.iso8601>20200817T17:58:57</dateTime.iso8601></value></param>
      <param><value><string>3139CDCE0C0457ADFA560295376C150D55C934E7</string></value></param>
    </params>
  </methodCall>

RESPONSE

STATUS 200 OK

SCHEMA

Field	Type	Description
`resultCode`	integer	Status code indicating transaction result
`approvalAmount`	integer	(Optional) When used in combination with result code 2, on transactions that support partial authorisation, the amount of the authorisation value to be partially approved in cents
`actualBalance`	integer	(Optional) Actual/settled balance in cents
`balanceAmount`	integer	(Optional) Available balance in cents
`addressVerificationResult`	integer	(Optional) Address Verification Result


  <?xml version="1.0" encoding="UTF-8"?>
<methodResponse>
  <params>
    <param>
      <value>
        <struct>
          <member>
            <name>resultCode</name>
            <value><int>1</int></value>
          </member>
        </struct>
      </value>
    </param>
  </params>
</methodResponse>