Last transaction void
Purpose
This command is used by the partner to initiate a reversal/void of the last processed transaction on the terminal. After successfully received request for MPRLastTxnVoid call the merchant must check for transaction on the myPOS device (press button O). Please refer to Process flow examples for more details.
Method properties
Property |
Typical value |
Type |
Presence |
Description |
---|---|---|---|---|
key_index | 1 | Int | M | Identifier of the private key used for the signature. |
version | 1.0 | String | M | The version of the protocol used for transition. |
login | name@website.com | String | M | Identifier of the partner. |
tid | 90000015 | AN(8) | M | Terminal ID |
ruid | 201203319999999 | String | M | Unique identifier of the submitted request. Up to 255 characters. |
ruid_original | 201203319999999 | String | M | Indicates the ruid that was presented in the original MPRPurchase call. |
amount | 23.45 | N(6,2) | M | The amount of the requested payment. |
signature | Byte[] | BASE64 | M | SHA-256 HASH for all properties in the command signed with the private key. The signature parameter is not used to calculate the hash. |
Response properties
Property |
Typical value |
Type |
Presence |
Description |
---|---|---|---|---|
key_index | 1 | Int | ME | Echo from MPRLastTxnVoid. |
version | 1.0 | String | ME | Echo from MPRLastTxnVoid. |
login | name@website.com | String | ME | Echo from MPRLastTxnVoid. |
tid | 90000015 | AN(8) | ME | Echo from MPRLastTxnVoid. |
ruid | 201203319999999 | String | ME | Echo from MPRLastTxnVoid. |
ruid_original | 201203319999999 | String | ME | Echo from MPRLastTxnVoid. |
amount | 23.45 | N(6,2) | ME | Echo from MPRLastTxnVoid. |
status | 0 | N(2) | M | Status of the request. For more information check Status Messages. |
status_msg | OK | String | O | Additional details about the received status. |
signature | Byte[] | BASE64 | M | SHA-256 HASH for all properties in the command signed with the private key. The signature parameter is not used to calculate the hash. |
Example of the request
<urn:MPRLastTxnVoid xmlns:urn="urnIPayService">
<urn:key_index>1</urn:key_index>
<urn:version>1.0</urn:version>
<urn:login>name@website.com</urn:login>
<urn:tid>90000015</urn:tid>
<urn:ruid>201403319999999</urn:ruid>
<urn:ruid_original>201203319999999</urn:ruid_original>
<urn:amount>23.45</urn:amount>
<urn:signature>bUViE5SzWy9iYpWzxlEVO/8Yb6bvtJVn1P6/rat5NBdgJaBU7OxeRm8rxi/fW1xuekqDM06F4MbzUPnTIA/sZ1ZwlMjSTExY5+7DqkdejN7mDgnB8zogrOfF6/P1snxuNgPRtHuJ0ZeTdTWNm9kKPGE7IadvIGtOpF+7yspfWd4=</urn:signature> </urn:MPRLastTxnVoid>
<MPRLastTxnVoidResponse xmlns:urn="urnIPayService">
<MPRLastTxnVoidResult xmlns:a="http://schemas.datacontract.org/2004/07/iPay.Core" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<a:key_index>1</a:key_index>
<a:version>1.0</a:version>
<a:login>name@website.com</a:login>
<a:tid>90000015</a:tid> <a:ruid>201403319999999</a:ruid>
<a:ruid_original>201203319999999</a:ruid_original>
<a:amount>23.45</a:amount> <a:status>0</a:status>
<a:status_msg>OK</a:status_msg>
<a:signature> bUViE5SzWy9iYpWzxlEVO/8Yb6bvtJVn1P6/rat5NBdgJaBU7OxeRm8rxi/fW1xuekqDM06F4MbzUPnTIA/sZ1ZwlMjSTExY5+7DqkdejN7mDgnB8zogrOfF6/P1snxuNgPRtHuJ0ZeTdTWNm9kKPGE7IadvIGtOpF+7yspfWd4=</a:signature>
</MPRLastTxnVoidResult>
</MPRLastTxnVoidResponse>
Example of the response