Charge a fee to a card (or pocket if applicable).
Request Path Parameters
| Parameter | type | Limits | required | Description |
|---|---|---|---|---|
| terminalID | String | 10 characters | ✓ | The Paymentology issued terminal id of the terminal requesting the transaction |
| customerReference | String | 1-20 characters | ✓ | Customer reference linked with this card |
| trackingNumber | String | 1-20 characters | ✓ | The tracking number of the card to either deduct, or to which the given pocket belongs |
| pocketUUID | String | 0-255 characters | ✓ | The UUID of the type of pocket to be deducted if applicable. Else, leave empty. |
| feeTypeID | Integer | ✓ | The identifier depicting the type of fee to be deducted. The list of Fee type identifiers can be found here | |
| requestAmount | Integer | ✓ | The requested amount to be deducted from the card as a fee, in cents | |
| transactionID | String | 1-255 characters | ✓ | A unique identifier generated by the client, which must not be duplicated over time. |
| transactionDate | Date | ✓ | Transaction date generated by the calling client | |
| checksum | String | 1-255 characters | ✓ | HMAC-SHA256 hashed signature of the concatenated method name with all argument values using the terminal password as private key |
<methodCall>
<methodName>InsertTransactionFee</methodName>
<params>
<param>
<value>
<string>1101611900</string>
</value>
</param>
<param>
<value>
<string>1111116791</string>
</value>
</param>
<param>
<value>
<string>1111101179561830</string>
</value>
</param>
<param>
<value>
<int>10</int>
</value>
</param>
<param>
<value>
<int>100</int>
</value>
</param>
<param>
<value>
<string>111c42f11ca01</string>
</value>
</param>
<param>
<value>
<dateTime.iso8601>2016-05-18T10:24:51</dateTime.iso8601>
</value>
</param>
<param>
<value>
<string>b1e0d112d9f67eb00d59d980dce19c9fd11fc1e1</string>
</value>
</param>
</params>
</methodCall>
Response Parameters
| Field | type | Description |
|---|---|---|
| terminalID | String | Echo |
| customerReference | String | Echo |
| trackingNumber | String | Echo |
| pocketUUID | String | Echo |
| feeTypeID | String | Echo |
| requestAmount | String | Echo |
| balance | String | Array of the balances of the cards pockets |
| clientTransactionID | String | Echo |
| serverTransactionID | String | Transaction id number generated by Paymentology |
| resultCode | String | Status code indicating transaction result |
| resultText | String | Status text indicating transaction result |
<methodResponse>
<params>
<param>
<value>
<struct>
<member>
<name>feeTypeID</name>
<value>
<int>10</int>
</value>
</member>
<member>
<name>requestAmount</name>
<value>
<int>100</int>
</value>
</member>
<member>
<name>profileNumber</name>
<value>
<string>1111110091</string>
</value>
</member>
<member>
<name>balanceAmount</name>
<value>
<int>11195</int>
</value>
</member>
<member>
<name>resultText</name>
<value>
<string>OK</string>
</value>
</member>
<member>
<name>transactionDate</name>
<value>
<dateTime.iso8601>20160518T10:24:51</dateTime.iso8601>
</value>
</member>
<member>
<name>serverTransactionID</name>
<value>
<string>1111110001-b7e5d652d9f67eb77d50d980dce19c9fd16fc1e1</string>
</value>
</member>
<member>
<name>expiryDate</name>
<value>
<dateTime.iso8601>20491231T00:00:00</dateTime.iso8601>
</value>
</member>
<member>
<name>clientTransactionID</name>
<value>
<string>101c42f05ca01</string>
</value>
</member>
<member>
<name>resultCode</name>
<value>
<int>1</int>
</value>
</member>
<member>
<name>terminalID</name>
<value>
<string>0011111100</string>
</value>
</member>
<member>
<name>cardNumber</name>
<value>
<string>1111111179561830</string>
</value>
</member>
<member>
<name>authNumber</name>
<value>
<int>0001</int>
</value>
</member>
</struct>
</value>
</param>
</params>
</methodResponse>