Mass codes for physical products

Put unique, single-use loyalty codes on bottle caps, boxes, tags, or receipts. Customers type or scan the code in the Rigaly app and instantly earn points at your business. Key properties:

Up to 32,768 codes per batch, generated instantly — create multiple batches for larger runs.
Codes are cryptographically signed — they can’t be guessed or counterfeited, and Rigaly doesn’t need to store them individually. Counterfeiting attempts are counted per batch (failed_attempts in the stats) and you can deactivate a batch at any time.
You’re only charged the per-transaction fee when a code is actually redeemed. Printing a million caps costs you nothing in Rigaly fees until customers start claiming.
Codes are human-friendly: SUMMER-595Y-003-GGC-98R — just 13 characters to type (the prefix and hyphens are optional), no ambiguous characters (no I/L/O/U), case-insensitive.

1. Create a batch

curl -X POST https://api.rigaly.com/api/v1/code-batches \
  -H "Authorization: Bearer rgly_sk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Summer 2027 bottles",
    "points": 250,
    "quantity": 30000,
    "expires_at": "2027-12-31T23:59:59Z",
    "prefix": "SUMMER"
  }'

const response = await fetch("https://api.rigaly.com/api/v1/code-batches", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.RIGALY_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    name: "Summer 2027 bottles",
    points: 250,          // each code awards 250 points
    quantity: 30000,
    expires_at: "2027-12-31T23:59:59Z",
    prefix: "SUMMER",     // cosmetic, appears on every printed code
  }),
});
const { batch, example_code } = (await response.json()).data;
console.log(`Batch ${batch.id} — codes look like: ${example_code}`);

response = requests.post(
    "https://api.rigaly.com/api/v1/code-batches",
    headers={"Authorization": f"Bearer {os.environ['RIGALY_API_KEY']}"},
    json={
        "name": "Summer 2027 bottles",
        "points": 250,
        "quantity": 30000,
        "expires_at": "2027-12-31T23:59:59Z",
        "prefix": "SUMMER",
    },
)
data = response.json()["data"]
print(f"Batch {data['batch']['id']} — codes look like: {data['example_code']}")

<?php
$ch = curl_init("https://api.rigaly.com/api/v1/code-batches");
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer " . getenv("RIGALY_API_KEY"),
        "Content-Type: application/json",
    ],
    CURLOPT_POSTFIELDS => json_encode([
        "name" => "Summer 2027 bottles",
        "points" => 250,
        "quantity" => 30000,
        "expires_at" => "2027-12-31T23:59:59Z",
        "prefix" => "SUMMER",
    ]),
]);
$data = json_decode(curl_exec($ch), true)["data"];
echo "Codes look like: " . $data["example_code"];

2. Export the codes for production

Download the full list as CSV (columns code,serial,deep_link) and hand it to your printer or packaging manufacturer. Exports stream and finish in seconds even for a full batch, and can be re-downloaded any time.

curl "https://api.rigaly.com/api/v1/code-batches/{batchId}/export?format=csv" \
  -H "Authorization: Bearer rgly_sk_YOUR_KEY" \
  -o summer-2027-codes.csv

3. Print each code as a deep-link QR (required)

A bare code printed on a bottle cap is meaningless out of context — customers won’t know what it’s for or where to enter it. Always print the QR code of the deep_link URL the export gives you for every code:

https://link.rigaly.com/code/SUMMER-595Y-003-GGC-98R

Scanning it with any phone camera does the right thing automatically:

Rigaly app installed → the app opens with the code pre-filled, one tap to claim.
App not installed → an install page opens (App Store / Google Play); after installing, the customer can claim the printed code.
Scanned on a desktop → a page shows the code and a QR to continue on the phone.

Print the human-readable code next to the QR as a fallback — the app also accepts typed codes (case-insensitive, hyphens optional).

Any standard QR library or print-shop workflow works: feed the deep_link column straight into the QR generator, one image per row.

4. Customers claim in the Rigaly app

No integration needed on your side: customers scan the QR (or type the code) and the points land instantly — tier multipliers included. Each code works exactly once.

5. Monitor and manage

# Redemption stats
curl https://api.rigaly.com/api/v1/code-batches/{batchId} \
  -H "Authorization: Bearer rgly_sk_YOUR_KEY"
# → { "claimed": 1204, "remaining": 28796, "points_issued": 301000, "failed_attempts": 0, ... }

# Customer support: check a specific code's status without claiming it
curl -X POST https://api.rigaly.com/api/v1/code-batches/verify \
  -H "Authorization: Bearer rgly_sk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"code": "SUMMER-595Y-003-GGC-98R"}'

# Kill switch: stop all further claims (e.g. codes leaked before launch)
curl -X POST https://api.rigaly.com/api/v1/code-batches/{batchId}/deactivate \
  -H "Authorization: Bearer rgly_sk_YOUR_KEY"

Billing

Event	Per-transaction fee
Creating a batch (any size)	$0
Exporting / re-exporting codes	$0
A customer redeems a code	1 standard transaction fee

Unredeemed codes never cost anything — ideal for mass-produced items where only a fraction of codes get claimed.

Getting Started

Guides

Mass codes for physical products

1. Create a batch

2. Export the codes for production

3. Print each code as a deep-link QR (required)

4. Customers claim in the Rigaly app

5. Monitor and manage

Billing

​1. Create a batch

​2. Export the codes for production

​3. Print each code as a deep-link QR (required)

​4. Customers claim in the Rigaly app

​5. Monitor and manage

​Billing

1. Create a batch

2. Export the codes for production

3. Print each code as a deep-link QR (required)

4. Customers claim in the Rigaly app

5. Monitor and manage

Billing