In Nexo Retail protocol, a Payment message is initiated by the Sale System, at the end of the purchase of services or goods, to request to the POI the payment of the purchase by the customer using a payment card.
Nexo Payment Request Examples
XML Format
<?xml version="1.0"?>
<SaleToPOIRequest>
<MessageHeader MessageClass="Service" MessageCategory="Payment" MessageType="Request" ServiceID="205" SaleID="SaleTermA" POIID="ArkosTerm1"/>
<PaymentRequest>
<SaleData>
<SaleTransactionID TransactionID="00341" TimeStamp="2018-08-01T09:13:51.0+01:00"/>
<SaleToAcquirerData>ABC123</SaleToAcquirerData>
</SaleData>
<PaymentTransaction>
<AmountsReq Currency="EUR" RequestedAmount="74.80"/>
<TransactionConditions CustomerLanguage="en"/>
<SaleItem ItemID="1" ProductCode="101" ItemAmount="2.50">
<Quantity>1</Quantity>
<UnitPrice>2.50</UnitPrice>
<ProductLabel>Game of Thrones Season 7 Ep 6 TV Series</ProductLabel>
<AdditionalProductInfo>Beyond the Wall</AdditionalProductInfo>
</SaleItem>
<SaleItem ItemID="2" ProductCode="102" EanUpc="84116369" ItemAmount="2.30">
<Quantity>5</Quantity>
<UnitPrice>0.46</UnitPrice>
<TaxCode>15</TaxCode>
<ProductLabel>Mineral Water 500mL</ProductLabel>
</SaleItem>
<SaleItem ItemID="3" ProductCode="103" ItemAmount="70">
<Quantity>2</Quantity>
<UnitPrice>35</UnitPrice>
<ProductLabel>Billet Spectacle SUGAR SAMMY Theatre Alhambra Paris Catégorie 1 - Balcon</ProductLabel>
<AdditionalProductInfo>18-aoû-2018 à 9:30PM</AdditionalProductInfo>
</SaleItem>
</PaymentTransaction>
<PaymentData PaymentType="Normal"/>
</PaymentRequest>
</SaleToPOIRequest>
JSON Format
{
"SaleToPOIRequest" :
{
"MessageHeader" :
{
"MessageClass" : "Service",
"MessageCategory" : "Payment",
"MessageType" : "Request",
"ServiceID" : "205",
"SaleID" : "SaleTermA",
"POIID" : "ArkosTerm1"
},
"PaymentRequest" :
{
"SaleData" :
{
"SaleTransactionID" :
{
"TransactionID" : "00341",
"TimeStamp" : "2018-08-01T09:13:51.0+01:00"
},
"SaleToAcquirerData" : "ABC123"
},
"PaymentTransaction" :
{
"AmountsReq" :
{
"Currency" : "EUR",
"RequestedAmount" : "74.80"
},
"TransactionConditions" :
{
"CustomerLanguage" : "en"
},
"SaleItem":
[
{
"ItemID": "1",
"ProductCode": "101",
"ItemAmount": "2.50",
"Quantity": "1",
"UnitPrice": "2.50",
"ProductLabel": "Game of Thrones Season 7 Ep 6 TV Series",
"AdditionalProductInfo": "Beyond the Wall"
},
{
"ItemID": "2",
"ProductCode": "102",
"EanUpc": "84116369",
"ItemAmount": "2.30",
"Quantity": "5",
"UnitPrice": "0.46",
"TaxCode": "15",
"ProductLabel": "Mineral Water 500mL"
},
{
"ItemID": "3",
"ProductCode": "103",
"ItemAmount": "70",
"Quantity": "2",
"UnitPrice": "35",
"ProductLabel": "Billet Spectacle SUGAR SAMMY Theatre Alhambra Paris Catégorie 1 - Balcon",
"AdditionalProductInfo": "18-aoû-2018 à 9:30PM"
}
]
},
"PaymentData" :
{
"PaymentType" : "Normal"
}
}
}
}
Nexo Payment Response Examples
XML Format
<?xml version="1.0"?>
<SaleToPOIResponse>
<MessageHeader MessageClass="Service" MessageCategory="Payment" MessageType="Response" ServiceID="205" SaleID="SaleTermA" POIID="ArkosTerm1"/>
<PaymentResponse>
<Response Result="Success"/>
<SaleData>
<SaleTransactionID TransactionID="00341" TimeStamp="2018-08-01T09:13:51.0+01:00"/>
</SaleData>
<POIData>
<POITransactionID TransactionID="123456" TimeStamp="2018-08-01T09:13:52.0+01:00"/>
</POIData>
<PaymentResult>
<AmountsResp Currency="EUR" AuthorizedAmount="74.80">
<PaymentAcquirerData AcquirerID="497867" MerchantID="mer77-130209" AcquirerPOIID="456">
<ApprovalCode>032983</ApprovalCode>
</PaymentAcquirerData>
</PaymentResult>
<PaymentReceipt DocumentQualifier="CustomerReceipt">
<OutputContent OutputFormat="Text">
<OutputText>MY STORE\n</OutputText>
<OutputText>Oxford Street\nLondon\nMER77130209\n99999999\n\nA0000000042010\nVISA\nXxxxxxxxxxxx1234 999\n\n01/08/2018 09:13:52\n</OutputText>
<OutputText>AMOUNT 74,80 EUR\nPAYMENT APPROVED\n\nCUSTOMER RECEIPT</OutputText>
</OutputContent>
</PaymentReceipt>
</PaymentResponse>
</SaleToPOIResponse>
JSON Format
{
"SaleToPOIResponse" :
{
"MessageHeader" :
{
"MessageClass" : "Service",
"MessageCategory" : "Payment",
"MessageType" : "Response",
"ServiceID" : "205",
"SaleID" : "SaleTermA",
"POIID" : "ArkosTerm1"
},
"PaymentResponse" :
{
"Response" :
{
"Result": "Success"
},
"SaleData" :
{
"SaleTransactionID" :
{
"TransactionID" : "00341",
"TimeStamp" : "2018-08-01T09:13:51.0+01:00"
}
},
"POIData" :
{
"POTransactionID" :
{
"TransactionID" : "123456",
"TimeStamp" : "2018-08-01T09:13:52.0+01:00"
}
},
"PaymentResult" :
{
"AmountsResp" :
{
"Currency" : "EUR",
"AuthorizedAmount" : "74.80"
},
"PaymentAcquirerData" :
{
"AcquirerID" : "497867",
"MerchantID" : "mer77-130209",
"AcquirerPOIID" : "456",
"ApprovalCode" : "032983"
},
},
"PaymentReceipt" :
[
{
"DocumentQualifier" : "CustomerReceipt",
"OutputContent" :
{
"OutputFormat" : "Text",
"OutputText" :
[
"MY STORE\n",
"Oxford Street\nLondon\nMER77130209\n99999999\n\nA0000000042010\nVISA\nXxxxxxxxxxxx1234 999\n\n01/08/2018 09:13:52\n",
"AMOUNT 74,80 EUR\nPAYMENT APPROVED\n\nCUSTOMER RECEIPT"
]
}
}
]
}
}
}