Payment notification for successful or unsuccessful payment

 

Purpose


The myPOS system will send the status of each successfully submitted financial request. The MPRNotify command will be initiated once the merchant completes the payment on the myPOS device. For full steps of the payment process please refer to Appendix III / Process flow examples. The response will be sent to the partner web address of the service supplied during the integration with the myPOS service.

 

 

Method properties

Property

Typical value

Type

Presence

Description

key_index 1 Int ME Identifier of the private key used for the signature.
version 1.0  String  ME The version of the protocol used for transition.
login name@website.com String ME Identifier of the partner. 
tid 90000015 AN(8) ME Terminal ID 
ruid 201203319999999 String  ME Unique identifier of the submitted request. Up to 255 characters.
amount 23.45 N(6,2) ME The amount of the requested payment.
response_code 00 N(2) C Response code from the issuer.
00 – transaction approved by the issuer;
≠00 – the Issuer or the card declines the transaction.
auth_code VCQSIM AN(6) C Authorization code from the issuer. This code is obtained after successful authorization only. Otherwise, the field will be empty.
rrn 219159246364 N(12) C Retrieval reference number. Set by the terminal/acquirer.
stan 000029 N(6) C System Trace Audit Number / Invoice. Enumerator from the terminal. Increments on every transaction attempt. Values from 000001 to 999999. Unique when combined with date.
merch_txn_date 2015-06-29 YYYY-MM-DD C Transaction date as determined by the terminal.
merch_txn_time 18:17:25 HH:MM:SS C Transaction time as determined by the terminal.
mid 000000000000096 AN(15) C Merchant ID as specified in the terminal configuration. Setup by the acquirer at merchant contracting.
merch_name MYPOS *COMPANY AN(22) C Merchant name as specified in the terminal configuration. Setup by the acquirer at merchant contracting.
merch_address_line1 STOURPORT-ON-SEVERN AN(32) C Merchant address line 1 as specified in the terminal configuration. Setup by the acquirer at merchant contracting.
merch_address_line2 WORCESTE, UK AN(32) C Merchant address line 2 as specified in the terminal configuration. Setup by the acquirer at merchant contracting.
masked_pan *4521 AN(5) C Last 4 digits of the card PAN used for the payment.
emboss_name IVANOVA/MILENA AN(26) C Cardholder name (where applicable).
aid A0000000032020 AN(32) C AID as read from the chip card.
aid_name VISA VPay String C AID name as read from the chip card.
signature_required 1 N(1) C 0 – signature required
1 – signature not required
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.

 

Response properties

Property

Typical value

Type

Presence

Description

key_index 1 Int ME Identifier of the private key used for the signature.
version 1.0  String  ME  The version of the protocol used for transition.
login name@website.com String ME Identifier of the partner. 
tid 90000015 AN(8) ME  Terminal ID 
ruid 201203319999999 String  ME Unique identifier of the submitted request. Up to 255 characters.
amount 23.45 N(6,2) ME The amount of the requested payment.
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 call when the payment was successfully processed:

<urn:MPRNotify 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>201203319999999</urn:ruid> 
  <urn:amount>23.45</urn:amount> <urn:response_code>00</urn:response_code> 
  <urn:auth_code>VCQSIM</urn:auth_code> <urn:rrn>219159246364</urn:rrn> 
  <urn:stan>000029</urn:stan> <urn:merch_txn_date>2015-06-29</urn:merch_txn_date> 
  <urn:merch_txn_time>18:17:25</urn:merch_txn_time>
  <urn:mid>000000000000096</urn:mid> 
  <urn:merch_name>MYPOS *COMPANY</urn:merch_name> 
  <urn:merch_address_line1>STOURPORT-ON-SEVERN</urn:merch_address_line1> 
  <urn:merch_address_line2>WORCESTE, UK</urn:merch_address_line2> 
  <urn:masked_pan>*4521</urn:masked_pan> 
  <urn:emboss_name>IVANOVA/MILENA</urn:emboss_name> 
  <urn:aid>A0000000032020</urn:aid> <urn:aid_name>VISA VPay</urn:aid_name> 
  <urn:signature_required>1</urn:signature_required> <urn:status>0</urn:status> 
  <urn:status_msg>OK</urn:status_msg> 
  <urn:signature>SLGoR09fPX3Ahn0HLuSwQ5y1IcsRrKEVf2aOPDkQZvPtZuDg1sQwibFQeWlQscnevyjHvQICii9XDmIY9FIDXk9O37HrekIPA6xfzNgCzKK1xzLb9V4nI1FgN+r+HlvsmIxQSV7eKfE8PQbo1ykvQbMcbQtkFzq3SLsK2hicslM=</urn:signature> 
</urn:MPRNotify>

 

Example of the call when the payment was unsuccessful:

	
<urn:MPRNotify xmlns:urn="urnIPayService"> 
  <urn:method>MPRNotify</urn:method> 
  <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>201203319999999</urn:ruid> 
  <urn:amount>23.45</urn:amount> 
  <urn:response_code>05</urn:response_code> 
  <urn:auth_code> </urn:auth_code> 
  <urn:rrn>219159246364</urn:rrn> 
  <urn:stan>000029</urn:stan> 
  <urn:merch_txn_date>2015-06-29</urn:merch_txn_date> 
  <urn:merch_txn_time>18:17:25</urn:merch_txn_time> 
  <urn:mid>000000000000096</urn:mid> 
  <urn:merch_name>MYPOS *COMPANY</urn:merch_name> 
  <urn:merch_address_line1>STOURPORT-ON-SEVERN</urn:merch_address_line1> 
  <urn:merch_address_line2>WORCESTE, UK</urn:merch_address_line2> 
  <urn:masked_pan>*4521</urn:masked_pan> 
  <urn:emboss_name>IVANOVA/MILENA</urn:emboss_name> 
  <urn:aid>A0000000032020</urn:aid> 
  <urn:aid_name>VISA VPay</urn:aid_name> 
  <urn:signature_required>1</urn:signature_required> 
  <urn:status>13</urn:status> 
  <urn:status_msg>E_UNSUCCESSFUL_PAYMENT</urn:status_msg>  
 <urn:signature>SLGoR09fPX3Ahn0HLuSwQ5y1IcsRrKEVf2aOPDkQZvPtZuDg1sQwibFQeWlQscnevyjHvQICii9XDmIY9FIDXk9O37HrekIPA6xfzNgCzKK1xzLb9V4nI1FgN+r+HlvsmIxQSV7eKfE8PQbo1ykvQbMcbQtkFzq3SLsK2hicslM=</urn:signature> 
</urn:MPRNotify>