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.
Comments
0 comments
Please sign in to leave a comment.