API call: MPRLastTxnVoid

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	M	Identifier of the partner.
key_index	1	Int	M	Identifier of the private key used for the signature.
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
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>

Example of the response

<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>