Implement a POS with static QR¶

When using a POS with a static QR, the QR code can be scanned before or after the POS is ready for submitting the payment request. The POS should submit a payment request (POST /payment_request/) passing in the QR "shortlink ID" or QR serial number as the customer. mCASH will then match with the customer who scans the QR.

The default behaviour is to match the last scan in a 60 second timeframe before the scan happens, and to keep listening for scans until the payment request is either picked up, or aborted.

If feasible in the POS code, one will get optimal results if the POS also passes max_scan_age. This should be set to the number of seconds since the previous payment done at the same POS (with any payment instruments, not only mCASH!!); this will naturally cause the scan to match the "current customer" in line at the POS, but not somebody who scanned earlier. In the example below, 341

If the POS does not know the time that has passed since the previous purchase, it is better to let mCASH control max_scan_age and not set it.

Example data to POST /payment_request/:

{
    "customer": "shortlink_sn:0123456789012",
    "max_scan_age": 341,
}