Developer
  • Getting started keyboard_arrow_down

    Discover

    • arrow_forward
      EV Charging

      Discover our unattended POS solution for the ev market

    Our solutions

    • arrow_forward
      CCV Terminal

      Integrate with a CCV Terminal

    • arrow_forward
      SoftPOS

      Turn your own device into a payment terminal

    • arrow_forward
      CCV Online Payments

      Accepting online payments in your platform without technical knowledge

    • arrow_forward

    • arrow_forward

    Connect to the CCV Platform

    Integrate our products into your software. Let's make payment happen together!

    Look at all the possibilities
  • Documentation
menu
    • Tokenization Terminal_features basic_operations Payment_features API_Reference

Return to solutions

  • Generalexpand_more
    • Getting started
    • Brands
    • Supported languages
  • basic operationsexpand_more
    • Make a payment
    • Cancel a payment
    • Handling receipts
    • Show display messages
    • Recover a payment
  • Payment featuresexpand_more
    • Authorise
    • Capture
  • Terminal featuresexpand_more
    • Transaction overview
    • Get available brands
    • Period closing
    • Get status
  • Tokenizationexpand_more
    • Get a card token
    • Read a mifare card
    • Custom text on terminal
  • API Referenceexpand_more
    • API reference

warning


The Android REST API is still in BETA. This functionality will soon be available.

Welcome

Hi fellow code warrior, we hope you enjoy our local payment REST API and to keep evolving we want to collect as much feedback as possible.
So if you have any remarks/improvements please share it with us here.

How does the local REST API work?

  • It is an Android background-service which automatically starts-up/restarts
  • The api is reachable on the next endpoint: http://127.0.0.1:8080
  • The api-reference can be found here

Before starting the integration you should know about next points concerning the API:

  • As we await all terminal communication in the service we use extended timeout requests. It is important that you add an read-timeout of at least 7 minutes in your http-client (For okhttp this can be done using this feature), this timeout of 7 minutes is essential for the correct functioning of the terminal.

The following steps will guide you through your journey as a ccv integrator:

  1. Start the terminal and connect it to the internet
  2. Verify if the CCV PayProxy is installed
  3. Follow the flow steps described above and start your integration journey

The demo-project contains all possible methods and can be found here

To configure the demo app to use the REST api, follow the next actions:

  1. Open the ‘mAPI Demo’ app
  2. Go to ‘UNATTENDED TERMINAL’
  3. Go to the settings (option menu top right)
  4. Enable the ‘REST API’ switch
  5. Save

Now the mAPI demo application is configured to use the REST API to communicate with the payment application.

Go to

Home
Documentation




Cookies Privacy Statement