Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The Sale Reference ID is a data tha that can be passed on and transfer from an Nexo requests Payment request incoming from the Sale Terminal. In order to display such data to the message response from Arkos, this one needs need to be added to the Aquired Proprietery Proprietary Data directory.

To do so, the following block of code has been implemented and added in the Arkos Pay Application:

Code Block
languagejava
public static PaymentParams createFromRetail(NexoRequest req) {
        PaymentParams params = new PaymentParams();

        if (req instanceof PaymentRequest) {
            PaymentRequest paymentReq = (PaymentRequest) req;

            String saleReferenceID = paymentReq.SaleReferenceID;
            params.paramTree = TlvTree.FromRaw(paymentReq.preparedPaymentData);
            TlvTree acquirerProprietaryData = params.paramTree.AddChild(0xFFBF2F);
            acquirerProprietaryData.SetAscii(0xDFCF01,saleReferenceID);

            ...
            
        } else if (req instanceof ReversalRequest) {
            ...
            }
        } else {
            ...
        }
        ...
    }

The Retail Module (ASL) is accused of receiving the Payment XML file request where the Sale Reference ID is located in paymentReq.SaleReferenceID. This one is then passed in ArksoPay through saleReferenceID for it to get set, afterwards, in the ACQUIRER_PROPRIETARY_DATA directory.

The previously given script will provide you details of the implementation made for the addition of the Sale Reference ID attribute in the ACQUIRER_PROPRIETARY_DATA directory. This one will be then appear be appearing in the Message Request Response from Nexo Retail (i.e: Accepted Authorization Request response).

...