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

version 3.0 String  M The version of the protocol used for transition.
login name@website.com String  Identifier of the partner. 
key_index 1 Int M Identifier of the private key used for the signature.
tid 90000015 AN(8) Terminal ID 
ruid 201203319999999 String  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

version 3.0 String  ME Echo from MPRLastTxnVoid.
login name@website.com String  ME  Echo from MPRLastTxnVoid.
key_index 1 Int 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:version>3.0</urn:version> 
  <urn:login>name@website.com</urn:login>
  <urn:key_index>1</urn:key_index> 
  <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:version>3.0</a:version> 
    <a:login>name@website.com</a:login>
    <a:key_index>1</a:key_index> 
    <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