☰

Navigation:

AP Concert Protocol

Information on support for the Association du Paiement Concert (AP Concert) ECR Integration Protocol.

Overview

Viva Android POS terminals support the Association du Paiement Concert ECR Integration Protocol. The dominant ECR integration protocol for the French market, allows easy integration with the Viva Android POS. Find out more about AP Concert.

It is possible to send ISV data to the Viva Android POS using the AP Concert protocol by using the CF field (private data) and populating the ISV_amount, ISV_clientId and ISV_clientSecret fields. The below example assumes we want to do a sale for 10€ with an ISV_amount of 1.23€:

So the test packet is as follows:

CZ0040300CJ012247300123456CA00201CB0041000CD0010CE003978CK003121CF183{"ISV_amount":123,"ISV_clientId":"auyf99x03sachvn3f5ogldykz8214c2o4vl8cvvs97p19.apps.vivapayments.com","ISV_clientSecret":"43ddf004fdf740c0a5b13477dff50991","ISV_sourceCode":"123456"}

Note the reference to CF183 in the above. The length of the ISV JSON here is 183 bytes. Each time the JSON string is modified the value of the CF length needs to change accordingly

Get Support

If you would like to integrate with Viva, or if you have any queries about our products and solutions, please see our Contact & Support page to see how we can help!