nexo Retailer

Make a Payment

Once there is a Login Session it is possible to make a Payment transaction. The PaymentRequest is used for purchase as well as refund.

Edit "Make a Payment" on GitHub

PaymentRequest

Send a PaymentRequest to make a payment or refund when there is a LoginSession. Make sure to save the MessageHeader since that is needed if abort is needed.



1
2
3
4
5
6
7
8
9
10
11
12



<SaleToPOIRequest>
    <MessageHeader MessageCategory="Payment" MessageClass="Service" MessageType="Request" POIID="A-POIID" ProtocolVersion="3.1" SaleID="ECR1" ServiceID="1524253497"/>
    <PaymentRequest>
        <SaleData TokenRequestedType="Customer">
            <SaleTransactionID TimeStamp="2023-09-08T16:17:32.9834651+02:00" TransactionID="1524253496"/>
        </SaleData>
        <PaymentTransaction>
            <AmountsReq CashBackAmount="0" Currency="SEK" RequestedAmount="38"/>
        </PaymentTransaction>
        <PaymentData PaymentType="Normal"/>
    </PaymentRequest>
</SaleToPOIRequest>
Name Lev Attributes Description
PaymentRequest 1    
SaleData 2 TokenRequestedType This will give a token for the card used. Only value available is Customer which gives a Card Number Alias which is a one way hash computed locally in the terminal. The CNA is the same for a specific card in all SwedbankPay terminals.
SaleTransactionID 3 TimeStamp Request timestamp local time with offset from GMT.
    TransactionID ID of the transaction set by the POS. This value is sent to the PosPay server, but is unfortunately not forwarded to clearing.
PaymentTransaction 2    
AmountsReq   RequestedAmount The total amount of transaction as a decimal value. Use a ’.’ for decimal point if needed.
    Currency As a 3 letter abbrivation - ISO-4217. Available are SEK, NOK, DKK, EUR.
    CashBackAmount As whereofvalue. Is included in RequestedAmount.
PaymentData 2 PaymentType Type of transaction that is requested. Availabel values are Normal, which is a payment and Refund.

Following a PaymentRequest