In-Person QR Code POS Scanner Integration

Integrate subscriber Digital ID QR scanning into physical store POS systems, tablets, or mobile barcode readers.

Select Tech Framework:

Step 1: Capture Member Digital ID QR Code Payload

Subscriber opens their Digital ID pass in the Patron member dashboard. The camera or USB barcode reader decodes the payload:

// Decoded QR Payload JSON
{
  "token": "ptr_qr_99283741823749",
  "member_identifier": "student.aisha@unilag.edu.ng"
}

Step 2: Validate Payload via Validation API (JS)

Post the payload to POST /api/merchant/qr-validate:

const res = await fetch('https://www.patron.com.ng/api/merchant/qr-validate', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer ptr_test_YOUR_API_KEY'
  },
  body: JSON.stringify({
    member_identifier: qrPayload.member_identifier,
    perk_id: 'prk_inperson_student'
  })
});

const data = await res.json();
if (data.success) {
  displayMemberIdBadge(data.member.full_name, data.member.photo_url, data.perk.title);
}