How to Integrate MobiPunch with CodeReadr

Postback URL

MobiPunch provides special Postback URL for CodeREADr that allow you to use the CodeREADr app to scan the barcode and use the PassSlot for validation & redemption.

Postback URL can be used when creating a service to "Redirect Scans to a Third Party Server".

In addition to that, the Postback URL can also be used with other type of services (e.g. "Validate Scans with a Database") in the advanced configuration section.

Validation URL

The validation URL needs to be constructed in the following way: https://cloud.punch.cards/scan/v1/codereadr/<TOKEN>

The token identifies the MobiPunch scanner that is used to represent the codeREADr app inside the MobiPunch validation and redemption system.

You can find the authentication token in the scanner view (under Username > Settings in the upper right menu).

Example: Sample Validation URL

If you have a scanner with authentication token Z3JJfA1RmIvcZmYyt3zx (EXAMPLE ONLY) the resulting URL would be

https://cloud.punch.cards/scan/v1/codereadr/Z3JJfA1RmIvcZmYyt3zx

Redemption URL

The redemption URL needs to be constructed in the following way: https://cloud.punch.cards/scan/v1/codereadr/<TOKEN>/redeem

This Postback URL will verify the validity of the pass, and if it is valid, it will redeem the pass automatically.

Example: Sample Redemption URL

Using the previous authentication token Z3JJfA1RmIvcZmYyt3zx (EXAMPLE ONLY) the resulting URL would be

https://cloud.punch.cards/scan/v1/codereadr/Z3JJfA1RmIvcZmYyt3zx/redeem

OPTIONAL: Database

You can use CodeREADr's database functionality to do some simple offline validation if you should not have internet connection available during the validation phase.

You can export all the pass data of your template (see template, export all pass data) and then import it to CodeREADr's web service.

The pass data CSV file needs some adaptations to be imported to CodeREADr's web service (see CodeREADr's documentation), but in most cases this should be rather simple.

Together with some special service configuration (e.g. mark duplicate scans as invalid) you can build a simple offline verification service.

In the advanced section of your service you can further use MobiPunch’s Postback Redemption URL to redeem passes once the scans are uploaded to CodeREADr's servers after you have scanned passes without internet connection.