QR Integration Guide

def generate_roommatik_qr(
issuer: str,
issuer_secret: str,
hotel_secret: str,
issue_dt: str, # “YYYYMMDDTHHMM”
activation_dt: str, # “YYYYMMDDTHHMM” or “”
expiry_dt: str, # “YYYYMMDDTHHMM”
room: str,
card_type: str, # “N” or “C”
doors_mask: str, # “0000”
qr_id: str,
max_cards: str = “”, # “” = unlimited
) -> str:
fields = [issuer, issue_dt, activation_dt, expiry_dt,
room, card_type, doors_mask, qr_id, max_cards] payload = “|”.join(fields)
key = (issuer_secret + hotel_secret).encode()
sig = hmac.new(key, payload.encode(), hashlib.sha1).digest()
signature = base64.b64encode(sig).decode()
return f”<{payload}|{signature}>”

# Example
qr = generate_roommatik_qr(
issuer=”ACME”,
issuer_secret=”123456″,
hotel_secret=”ABCDEF”,
issue_dt=”20210412T1800″,
activation_dt=”20210413T1200″,
expiry_dt=”20210415T1330″,
room=”101″,
card_type=”N”,
doors_mask=”000A”,
qr_id=”ab3245re12″,
max_cards=”2″,
)
print(qr)
# <ACME|20210412T1800|…|IeuEuUyoxK8rsaONgn24hQ5UJbg=>

function generateRoommatikQR({
issuer, // “ACME”
issuerSecret, // “123456”
hotelSecret, // “ABCDEF”
issueDt, // “YYYYMMDDTHHMM”
activationDt, // “YYYYMMDDTHHMM” or “”
expiryDt, // “YYYYMMDDTHHMM”
room, // “101”
cardType, // “N” | “C”
doorsMask, // “0000”
qrId, // “ab3245re12”
maxCards = “”, // “” = unlimited
}) {
const fields = [issuer, issueDt, activationDt, expiryDt,
room, cardType, doorsMask, qrId, maxCards];
const payload = fields.join(“|”);
const key = issuerSecret + hotelSecret;
const sig = createHmac(“sha1”, key).update(payload).digest(“base64”);
return `<${payload}|${sig}>`;
}

// Example
const qr = generateRoommatikQR({
issuer: “ACME”,
issuerSecret: “123456”,
hotelSecret: “ABCDEF”,
issueDt: “20210412T1800”,
activationDt: “20210413T1200”,
expiryDt: “20210415T1330”,
room: “101”,
cardType: “N”,
doorsMask: “000A”,
qrId: “ab3245re12”,
maxCards: “2”,
});
console.log(qr);

string GenerateRoommatikQR(
string issuer, string issuerSecret, string hotelSecret,
string issueDt, string activationDt, string expiryDt,
string room, string cardType, string doorsMask,
string qrId, string maxCards = “”)
{
var fields = new[] { issuer, issueDt, activationDt, expiryDt,
room, cardType, doorsMask, qrId, maxCards };
var payload = string.Join(“|”, fields);
var key = Encoding.UTF8.GetBytes(issuerSecret + hotelSecret);
using var hmac = new HMACSHA1(key);
var hash = hmac.ComputeHash(Encoding.UTF8.GetBytes(payload));
var signature = Convert.ToBase64String(hash);
return $”<{payload}|{signature}>”;
}