Payment Card Reader CAS Configuration

Payment Card Reader CAS Configuration

Currently, two different card reader vendors are supported in CAS.

Card readers currently support EUR transactions only.

  • Each connected Terminal must include the EUR fiat, and

  • include EUR in the respective AML/KYC setting.

Choose the reader you’re installing from this list to navigate to that specific Terminal configuration. The remainder of this guide is common to both variants:


Worldline Valina

Hardware installation on a BATMThree: https://generalbytes.atlassian.net/wiki/x/AQDo4

For each Terminal that has a Valina installed:

  1. Add the EUR fiat.

  2. Set the Terminal’s AML/KYC to use EUR.

  3. Add to the Terminal’s Custom Strings → special_configuration to include:

    1. cardpayment paymentcardreaderid=XXXXXXXX

    2. NOTE: both cardpayment and the paymentcardreaderid=XXXXXXXX strings are required!

Example:

  • Payment Card Reader ID = eight digits unique to each card reader.

  • These digits are labeled as a “TID#” on the device.


QpayPOS Q5000

QpayPOS web page for the Q5000: https://qpaypos.es/eu/q5000/

Hardware installation on a BATMFour: https://generalbytes.atlassian.net/wiki/spaces/ESD/pages/3773366273

Setup Instructions

For each Terminal that has a Q5000 installed:

  1. Add the EUR fiat.

  2. Set the Terminal’s AML/KYC to use EUR.

  3. Set the Terminal’s Custom Strings → special_configuration to include: cardpayment cardpaymenttype=qpay

    1. NOTE: both cardpayment cardpaymenttype=qpay strings are required!

Example Custom String:


Common Instructions

Activate in AML/KYC settings:
Enable the checkbox for card payments in each supported AML/KYC setting for the affected Terminal(s).

image-20250512-150726.png
  • Save the AML/KYC setting.

Reporting

After the first card transaction, a new section “payment_card_terminal” will appear in the Cash report:

image-20241128-125241.png

Clicking “SHOW TRANSACTIONS” on that page will now generate a card (only) transaction report:

Banknote History will now also list card payments (in the payment_card_terminal Cash Box):


An example of a card purchase at the BATM:

Qpay BATM3.mp4

Hardware Installation Instructions

Copyright © 2020-2025 General Bytes USA LLC